Поделиться через

Отчеты о CsP2PSession *

  • Статья

Коды URI REST CsP2PSession * предоставляют обобщенные сведения о количество Office 365 Lync Online peer-to-peer сеансов. Существует три отчеты, которые отличаются только в интервал времени, через который они сведение данных и использовать же Общая структура: день, неделю и месяц. Для простоты в этой теме описаны три отчета.

Дата последнего изменения: 17 сентября 2015 г.

Область применения: Office 365

Коды URI REST

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PSessionDaily[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PSessionWeekly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PSessionMonthly[?ODATA options]

Поля

В $select, $filter и $orderby параметры запроса ODATA2 можно указать следующие поля. Если указан параметр $select не возвращаются все поля.

Имя

WCF тип *

Тип EDM *

[В/Out] ** описание

Пример значения

Добавлено в версию обновления

Date

System.DateTime

Edm.DateTime

[In/Out] Дата и время окончания отчетного периода. В следующих разделах Дополнительные сведения о отчетных периодов.

Краткий формат даты (например, 03/10/2013) или Дата и время в кавычки (например, "03/10/2013 4:55 PM")

2013-V1

ID

long

Edm.Int64

[In/Out] Номер индекса записи отчета.

72

2013-V1

P2PApplicationSharingSessions

long

Edm.Int64

[In/Out] Номер приложения Peer-to-Peer (P2P), общий доступ к сеансов во время периода отчета.

182

2013-V1

P2PAudioSessions

long

Edm.Int64

[In/Out] Число одноранговых аудиосеансов во время периода отчета.

12

2013-V1

P2PFileTransferSessions

long

Edm.Int64

[In/Out] Количество одноранговых сеансов передачи файлов во время периода отчета.

42

2013-V1

P2PIMSessions

long

Edm.Int64

[In/Out] Количество одноранговых сеансов обмена мгновенными сообщениями, в течение периода отчета.

142

2013-V1

P2PVideoSessions

long

Edm.Int64

[In/Out] Количество одноранговых сеансов видеосвязи во время периода отчета.

1562

2013-V1

TenantGuid

System.guid

Edm.Guid

[In/Out] GUID организации.

16a58f78-539f-47f7-b9bf-02a63867d73b

2013-V1

TenantName

строка

Edm.String

[In/Out] Имя организации.

example.onmicrosoft.com

2013-V1

TotalP2PSessions

long

Edm.Int64

Количество одноранговых сеансов для всех типов в отчетного периода.

12587

2013-V1

* Тип WCF относится к типу данных .NET Framework, назначенный в поле при создании ссылки на службу Windows Communications Framework (WCF) в Visual Studio. Имя относится к модели данных ADO.NET сущности (EDM) типов, которые возвращаются в формате Atom отчеты.

** [In/Out]: для получения дополнительных сведений см входные параметры и сообщить о раздел столбцы выходные данные.

Замечания

Для включения в полученные числа сеансов, по крайней мере один участник должен являлся участником сеанса как своей учетной записи организации Office 365.

Участники сеанса, конференции с помощью мобильных устройств, например телефонов или планшетных компьютеров не включаются в отчет. По этой причине если все участники сеанса на мобильных устройствах этого сеанса, не отображаются в отчете.

Каждый элемент в отчете о включает несколько полей метаданных. Для получения дополнительных сведений см Распространенные метаданных, возвращаемых веб-службой отчетов Office 365.

Три типа отчетов отличаются только за время, описывающую каждой записи отчета. Время, указанная в поле Дата представляет окончания периода времени. Сообщает значения даты и времени в часовом поясе, указанном в заголовке X-timezone получить HTTPS. Если часовой пояс не указан, то используется время в формате UTC. Продолжительность времени, обнаруженных рассчитывается следующим образом.

Имя отчета

Период времени вычисления

Ежедневно (CsP2PSessionDaily)

Работы с отчетами день начинается точно полночь (00:00) и заканчивающейся только что до полуночи (23.59:59.9999) в тот же день. Последний день, обнаруженных будет последнего полного дня, для которого данные недоступны и не будут включены в текущий день. Дата и время возвращаются в поле Date представляет конца дня работы с отчетами.

Еженедельно (CsP2PSessionWeekly)

Начала работы с отчетами недели в точно полночь (00:00) преждевременного в воскресенье и заканчивается перед полночь (23:59:59.9999) на следующих ночь суббота. Недавно переданные запись — это один включает в себя текущего дня и таким образом обычно выходит за пределы при запросе отчета. Дата и время возвращаются в поле Date представляет конец данную неделю отчетов.

Ежемесячно (CsP2PSessionMonthly)

Работы с отчетами месяца начинается точно полночь (00:00) на первый день месяца и заканчивается перед полночь (23.59:59.9999) в последний календарный день месяца. Недавно переданные запись — это один включает в себя текущего дня и таким образом обычно выходит за пределы при запросе отчета. Дата и время возвращаются в поле Date представляет окончание работы с отчетами месяца.

Примеры

Следующий запрос и ответ пары показано, как получить отчет об активности группы по дням в формате JSON. Запрос и ответ для ясности были добавлены символы перевода строки.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PSessionDaily?
  $select=Date,TotalP2PSessions,P2PIMSessions,P2PAudioSessions,P2PVideoSessions,
    P2PApplicationSharingSessions,P2PFileTransferSessions&
  $format=Json

 {
    "d":
      {
        "results":
          [
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-10T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-10T00%3A00%3A00')",
                    "type":"TenantReporting.CsP2PSessionReport"
                  },
                "Date":"\/Date(1368144000000)\/",
                "TotalP2PSessions":"23",
                "P2PIMSessions":"12",
                "P2PAudioSessions":"8",
                "P2PVideoSessions":"1",
                "P2PApplicationSharingSessions":"2",
                "P2PFileTransferSessions":"1"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-13T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-13T00%3A00%3A00')",
                    "type":"TenantReporting.CsP2PSessionReport"
                  },
                "Date":"\/Date(1368403200000)\/",
                "TotalP2PSessions":"42",
                "P2PIMSessions":"16",
                "P2PAudioSessions":"18",
                "P2PVideoSessions":"7",
                "P2PApplicationSharingSessions":"3",
                "P2PFileTransferSessions":"5"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-14T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-14T00%3A00%3A00')",
                    "type":"TenantReporting.CsP2PSessionReport"
                  },
                "Date":"\/Date(1368489600000)\/",
                "TotalP2PSessions":"38",
                "P2PIMSessions":"18",
                "P2PAudioSessions":"8",
                "P2PVideoSessions":"3",
                "P2PApplicationSharingSessions":"7",
                "P2PFileTransferSessions":"5"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-22T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-22T00%3A00%3A00')",
                    "type":"TenantReporting.CsP2PSessionReport"
                  },
                "Date":"\/Date(1369180800000)\/",
                "TotalP2PSessions":"3",
                "P2PIMSessions":"1",
                "P2PAudioSessions":"0",
                "P2PVideoSessions":"0",
                "P2PApplicationSharingSessions":"0",
                "P2PFileTransferSessions":"2"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-24T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-24T00%3A00%3A00')",
                    "type":"TenantReporting.CsP2PSessionReport"
                  },
                "Date":"\/Date(1369353600000)\/",
                "TotalP2PSessions":"2",
                "P2PIMSessions":"1",
                "P2PAudioSessions":"0",
                "P2PVideoSessions":"0",
                "P2PApplicationSharingSessions":"0",
                "P2PFileTransferSessions":"1"
              }
          ]
      }
  }

Следующий запрос и ответ пары показано, как получить число сеансов, возникших каждый день между 20 мая и 25 мая. Этот запрос запрашивает данные в формате Atom. Разрывы были добавлены в запрос и ответ для наглядности.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PSessionDaily?
  $select=Date,TotalP2PSessions,P2PIMSessions,P2PAudioSessions,
    P2PVideoSessions,P2PApplicationSharingSessions,
    P2PFileTransferSessions&
  $filter=Date%20ge%20datetime'2013-05-20T00:00:00'%20and%20Date%20lt%20datetime'2013-05-26T00:00:00'&
  $format=Atom

<?xml version="1.0" encoding="utf-8"?>
<feed 
  xml:base="https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/" 
  xmlns="http://www.w3.org/2005/Atom" 
  xmlns:d="https://schemas.microsoft.com/ado/2007/08/dataservices" 
  xmlns:m="https://schemas.microsoft.com/ado/2007/08/dataservices/metadata">
  <id>https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PSessionDaily</id>
  <title type="text">CsP2PSessionDaily</title>
  <updated>2013-06-25T20:36:14Z</updated>
  <link rel="self" title="CsP2PSessionDaily" href="CsP2PSessionDaily" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
      CsP2PSessionDaily(datetime'2013-05-22T00%3A00%3A00')</id>
    <category term="TenantReporting.CsP2PSessionReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-06-25T20:36:14Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-22T00:00:00</d:Date>
        <d:TotalP2PSessions m:type="Edm.Int64">3</d:TotalP2PSessions>
        <d:P2PIMSessions m:type="Edm.Int64">1</d:P2PIMSessions>
        <d:P2PAudioSessions m:type="Edm.Int64">0</d:P2PAudioSessions>
        <d:P2PVideoSessions m:type="Edm.Int64">0</d:P2PVideoSessions>
        <d:P2PApplicationSharingSessions m:type="Edm.Int64">0</d:P2PApplicationSharingSessions>
        <d:P2PFileTransferSessions m:type="Edm.Int64">2</d:P2PFileTransferSessions>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
      CsP2PSessionDaily(datetime'2013-05-24T00%3A00%3A00')</id>
    <category term="TenantReporting.CsP2PSessionReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-06-25T20:36:14Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-24T00:00:00</d:Date>
        <d:TotalP2PSessions m:type="Edm.Int64">2</d:TotalP2PSessions>
        <d:P2PIMSessions m:type="Edm.Int64">1</d:P2PIMSessions>
        <d:P2PAudioSessions m:type="Edm.Int64">0</d:P2PAudioSessions>
        <d:P2PVideoSessions m:type="Edm.Int64">0</d:P2PVideoSessions>
        <d:P2PApplicationSharingSessions m:type="Edm.Int64">0</d:P2PApplicationSharingSessions>
        <d:P2PFileTransferSessions m:type="Edm.Int64">1</d:P2PFileTransferSessions>
      </m:properties>
    </content>
  </entry>
</feed>

Входные параметры и сообщить о выходных столбцов

[In/Out] индикаторов в таблице полей имеют следующие значения:

  • Поля, отмеченные [In] в поля в таблице в основном предназначены для использования в $filter=, $orderby= и другие параметры запроса, ограничивающие вводимых данных в отчете. Поля, отмеченные [In] в поля в таблице может быть включен параметр $select= и они будут отображаться в отчет операции, но они будут не содержат полезных данных.

  • Поля, отмеченные [In/Out] в поля, которые в таблице можно использовать в выделенный фрагмент столбца ($select=) и параметры ($filter= и $orderby=) ограничение записей. При включении одно из этих полей в параметре $select= , они будут отображаться в отчет операции и будет содержать полезные данные, если она доступна.

Совместимость

Отчеты о CsP2PSessionDaily, CsP2PSessionWeekly и CsP2PSessionMonthly были представлены в Служба Office 365 версии 2013-V1. Дополнительные сведения об управлении версиями можно Управление версиями в веб-службе отчетов Office 365.

Соответствующий командлеты PowerShell

Отчеты о CsP2PSession * возвращать те же данные в командлет Get-CsP2PSessionReportWindows PowerShell. 

Разрешения

Учетная запись для доступа к отчетов из требуются права администратора в организации, Office 365. При наличии в документ описания службы и возвращается пользователю $metadata документа отчета они имеют разрешения для извлечения данных из веб-службы REST. В этом отчете требует от пользователя быть назначена роль получателей только для просмотра. В структуре разрешения по умолчанию Office 365 пользователей со следующими разрешениями администратора может вызвать этот отчет: выставления счетов администратора, глобального администратора, пароль администратора, администратора служб и администратор управления пользователями.

Степень детализации данных, сохранение состояния и доступности

Информация, доступная через этих отчетов можно разделить на один день периодов, начиная с полуночи часовой пояс, вызывающему приложению в заголовке HTTP X-timezone .

Сведения для этого отчета можно найти в течение одного года или до отмены подписки.

События с задержкой в течение 24 часов, прежде чем они отображаются в отчете.