Relatórios de CsP2PSession *

Os URIs de REST CsP2PSession * fornecem estatísticas de resumo sobre o número de sessões do Office 365 Lync Online-a-ponto. Existem três relatórios que usam a mesma estrutura geral e diferem somente o intervalo de tempo durante os quais eles resumem os dados: diários, semanais e mensais. Para manter a simplicidade, os relatórios de três são detalhados neste tópico um.

Última alteração: quinta-feira, 17 de setembro de 2015

Aplica-se a: Office 365

URIs 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]

Campos

Os campos a seguir podem ser especificados em Opções de consulta ODATA2 $select, $filter e $orderby . Todos os campos são retornados se nenhuma opção $select for fornecida.

Nome

Tipo WCF *

Tipo EDM *

[Em/fora] * * descrição

Valores de exemplo

Adicionado ao serviço versão

Date

System.DateTime

Edm.DateTime

[/ Saída] A data de término e a hora do período do relatório. Consulte as seções a seguir para obter mais informações sobre períodos de relatório.

Data curta (por exemplo, 03/10/2013) ou Data hora com aspas (por exemplo, "03/10/2013 4:55 PM")

2013-V1

ID

Long

Edm.Int64

[/ Saída] O número de índice do registro do relatório.

72

2013-V1

P2PApplicationSharingSessions

Long

Edm.Int64

[/ Saída] O número de sessões durante o período do relatório de compartilhamento de aplicativo ponto a ponto (P2P).

182

2013-V1

P2PAudioSessions

Long

Edm.Int64

[/ Saída] O número de sessões de áudio P2P durante o período do relatório.

12

2013-V1

P2PFileTransferSessions

Long

Edm.Int64

[/ Saída] O número de sessões de transferência de arquivo P2P durante o período do relatório.

42

2013-V1

P2PIMSessions

Long

Edm.Int64

[/ Saída] O número de sessões de mensagens instantâneas P2P durante o período do relatório.

142

2013-V1

P2PVideoSessions

Long

Edm.Int64

[/ Saída] O número de sessões de vídeo P2P durante o período do relatório.

1562

2013-V1

TenantGuid

System.guid

Edm.Guid

[/ Saída] O GUID da organização.

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

2013-V1

TenantName

Cadeia de caracteres

Edm.String

[/ Saída] O nome da organização.

example.onmicrosoft.com

2013-V1

TotalP2PSessions

Long

Edm.Int64

O número de sessões de P2P de todos os tipos no período do relatório.

12587

2013-V1

* Tipo de WCF se refere ao tipo de dados .NET Framework atribuído ao campo quando você cria uma referência de serviço de comunicações Framework WCF (Windows) no Visual Studio. O tipo de EDM refere-se para os tipos de modelo de dados de entidade ADO.NET (EDM) retornados nos relatórios Atom formatada.

* * [/ Saída]: para obter mais informações, consulte os parâmetros de entrada e saída seção de colunas do relatório.

Comentários

Para ser incluído nos números de sessões relatados, pelo menos um participante deve ter participou da sessão como sua conta de usuário de organização do Office 365.

Os participantes da sessão que foram participando por meio de dispositivos móveis, como telefones ou tablets não são incluídos no relatório. Por esse motivo, se todos os participantes em uma sessão são em dispositivos móveis, essa sessão não aparecer no relatório.

Cada entrada no relatório inclui vários campos de metadados. Para obter mais informações, consulte Metadados comum retornados pelo serviço web de relatório do Office 365.

Os três tipos de relatório diferem na quantidade de tempo que cobre cada entrada do relatório. No momento relatadas no campo Date representa o fim do período de tempo. Datas e horas são relatadas no fuso horário especificado no cabeçalho X-timezone obter HTTPS. Se nenhum fuso horário é especificado, o horário UTC é usado. As durações de tempo relatados são calculadas da seguinte maneira.

Nome do relatório

Cálculo de período de tempo

Diário (CsP2PSessionDaily)

O relatório dia inicia à meia-noite precisamente (00: 00:00) e termina antes de meia-noite (23.59:59.9999...) no mesmo dia. O último dia relatado será o último dia completo para o qual os dados estão disponíveis e não incluirá o dia atual. A data e hora retornados no campo Date representa o fim desse dia de relatórios.

Semanal (CsP2PSessionWeekly)

Relatórios semana começa em precisamente meia-noite (00: 00:00), antecipado no domingo e termina antes de meia-noite (23:59:59.9999 …) a seguir noite de sábado. A entrada relatada mais recentemente é o que inclui o dia atual e, portanto, normalmente se estenderá além quando o relatório é solicitado. A data e hora retornados no campo Date representa o fim naquela semana de relatórios.

Mensal (CsP2PSessionMonthly)

O mês relatórios inicia à meia-noite precisamente (00: 00:00) no primeiro dia do mês e extremidades antes de meia-noite (23.59:59.9999...) no último dia naquele mês do calendário. A entrada relatada mais recentemente é o que inclui o dia atual e, portanto, normalmente se estenderá além quando o relatório é solicitado. A data e hora retornados no campo Date representa o fim naquele mês do relatório.

Exemplos

O seguinte par de solicitação e resposta demonstra como recuperar um relatório de atividade de grupo por dia, no formato JSON. Quebras de linha foram adicionadas para a solicitação e a resposta para manter a clareza.

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"
              }
          ]
      }
  }

O seguinte par de solicitação e resposta demonstra como recuperar o número de sessões que ocorreu a cada dia entre 20 de maio e 25 de maio. Esta consulta solicita as informações no formato Atom. Quebras de linha foram adicionadas para a solicitação e a resposta para manter a clareza.

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>

Parâmetros de entrada e relatar colunas de saída

Os indicadores de [/ saída] na tabela campos têm os significados a seguintes:

  • Campos marcados [In] nos campos de tabela destinam-se principalmente para uso em $filter=, $orderby= e outras opções de consulta que restringem quais entradas retorna o relatório. Campos marcados [In] em campos de tabela pode ser incluído a opção $select= e eles serão exibidos nas entradas de relatório, mas que não irão conter nenhum dado útil.

  • Campos marcados [/ saída] nos campos de tabela pode ser usada em Opções de ($filter= e $orderby=) de restrição de entrada e de seleção de coluna ($select=). Quando você inclui um desses campos na opção $select= , eles aparecerão nas entradas de relatório e irá conter dados úteis quando ele estiver disponível.

Compatibilidade

Os relatórios de CsP2PSessionDaily, CsP2PSessionWeekly e CsP2PSessionMonthly foram introduzidos no Office 365 service version 2013-V1. Para obter mais informações sobre o controle de versão, consulte Controle de versão no serviço da web de relatório do Office 365.

Cmdlets do PowerShell correspondentes

Os relatórios CsP2PSession * retornam as mesmas informações que o cmdlet Get-CsP2PSessionReportWindows PowerShell. 

Permissões

A conta que você acessar os relatórios do deve ter permissões administrativas nessa organização Office 365. Se o relatório está presente na descrição do serviço e o documento de $metadata retornada para o usuário, eles têm permissões para recuperar os dados do serviço web REST. Este relatório requer que o usuário a ser atribuído à função de destinatários de somente para exibição. Na estrutura de permissões de Office 365 padrão, os usuários com as seguintes permissões de administrador podem acessar este relatório: administrador de gerenciamento de usuário, administrador global, administrador de senha, administrador de serviço e administrador de faturamento.

Disponibilidade, persistência e granularidade de dados

Informações disponíveis por meio desses relatórios podem ser separadas em períodos de um dia, começando à meia-noite do fuso horário relatado pelo aplicativo de chamada no cabeçalho HTTP X-timezone .

As informações para esse relatório estão disponíveis por um período de um ano ou até que a assinatura será cancelada.

Eventos podem ser atrasados por até 24 horas antes que eles aparecem em um relatório.