Serviço Web de Relatório do Office 365
O Office 365 Reporting web service permite que os desenvolvedores integrem informações sobre email e spam, atividade do antivírus, status de conformidade e atividades do Lync Online a seus aplicativos de relatórios de serviços personalizados e portais da Web. Este tópico fornece uma visão geral sobre o serviço da Web REST, a arquitetura funcional, os relatórios disponíveis e outras maneiras de acessar os relatórios.
Última alteração: segunda-feira, 7 de dezembro de 2015
Aplica-se a: Office 365
Bem-vindo ao serviço Web de relatório do Office 365
O Office 365 Reporting web service permite que os desenvolvedores integrem informações sobre email e spam, atividade do antivírus, status de conformidade e conferências e sessões do Lync Online aos seus aplicativos de relatórios de serviços personalizados e portais da Web. Todos os relatórios disponíveis no portal do administrador, na planilha do Microsoft Excel para download, e aqueles acessados por meio do cmdlet do Windows PowerShell podem ser acessados por meio do Reporting web service. Os usuários que acessarem o Reporting web service devem ter direitos administrativos na organização.
Permissões de administrador
Para poder ver os relatórios, você precisa das permissões corretas no Office 365. Caso você ainda não possa vê-las, peça ao administrador da sua organização para adicionar você a uma das funções de administrador. Recomendamos começar pelo intervalo de administrador mais baixo, "Administrador de Serviço". Você também pode pedir a seu administrador para criar uma conta de administrador distinta, que pode ser usada apenas para explorar o sistema de relatórios.
Os relatórios do portal do administrador estão disponíveis em: https://portal.microsoftonline.com/Reports/AllReports.aspx. Haverá mais dados disponíveis se sua organização estiver ativa e tiver vários usuários, mas mesmo pequenas organizações podem ter vários spams e malware em seu email.
Arquitetura funcional
O diagrama conceitual de alto nível a seguir dá a você uma ideia de como o sistema de relatórios funciona.
.png "Office 365 Reporting web service architecture")
As fontes primárias de informações de relatórios são serviço do Exchange Online, serviços de proteção do Microsoft Forefront, serviço do Lync Online, servidores de caixa de correio do Exchange Server e Active Directory Domain Services (AD DS). As várias fontes depositam suas informações de log no data mart. Em uma escala em que o Office 365 está operando, milhares de servidores podem estar envolvidos alimentando dados no sistema de relatórios.
Devido ao enorme volume de dados e aos atrasos de replicação, pode levar algum tempo até que os dados estejam disponíveis para os relatórios. Em geral, isso requer apenas algumas horas, mas novas contas exigem, com certeza, mais tempo. Isso significa que o serviço Web de Relatório não se destina ao monitoramento atual do sistema. Ele serve mais para a análise do uso de recursos históricos.
Quando os dados do relatório são exibidos no data mart, eles podem ser retornados nas suas solicitações para o Reporting web service. O portal do administrador do Office 365 também obtém dados do Reporting web service.
Além do serviço Web de Relatório, há três outras maneiras de recuperar os relatórios. Você já conhece o serviço Web e o portal do administrador, mas você também pode baixar uma planilha personalizável que obtém seus dados do serviço Web. E, se sua situação exigir dados em scripts do Windows PowerShell, há cmdlets de relatório que você pode chamar por meio do Windows PowerShell remoto. As quatro maneiras de recuperar relatórios são comparadas na tabela a seguir.
Maneiras de obter os relatórios |
Facilidade de uso |
Personalizável |
Como chegar lá |
|---|---|---|---|
Listas e gráficos pré-definidos do centro de administração do Office 365 |
Simples, verificações de integridade e status interativo. |
Baixo. Filtragem interativa por data, regras de política de transporte acionadas e assim por diante. |
https://portal.office365.com/admin/default.aspx#AllReportsRootV2. Lembre-se: você deve estar conectado a uma conta com direitos de administrador para acessar os relatórios. |
Planilha para download |
Análise detalhada e flexível de dados de serviço históricos e em tempo real, por exemplo em scorecards baseados no Microsoft Excel. |
Médio. As atualizações podem exigir a reaplicação de personalizações e código de fonte interno não exposto. |
https://www.microsoft.com/pt-br/download/details.aspx?id=30716 |
Cmdlets do PowerShell de relatório |
É necessário usar scripts. Dados precisos para relatórios gerados periodicamente em ferramentas de manutenção de TI baseadas em script. |
Alto. Ideal para ferramentas analíticas baseadas em script. |
https://technet.microsoft.com/pt-br/library/jj200677(v=exchg.150).aspx |
Serviço Web de Relatório REST |
É necessário programar portais de monitoramento de serviço ou scorecards que exigem integração com serviços personalizados e que não sejam do Office 365. |
Muito alto. O serviço Web REST oferece filtragem de consulta ODATA2 e um IDE de programação completo no Microsoft Visual Studio. |
https://reports.office365.com/ecp/reportingwebservice/reporting.svc |
Com quatro maneiras distintas de obter os dados, como você pode ter a certeza de que todos os relatórios estão retornando os mesmos dados? A planilha e o portal do administrador chamam o Reporting web service, que, por sua vez, chama os cmdlets do Windows PowerShell. Você também pode chamar esses cmdlets diretamente. Os cmdlets do Windows PowerShell são os únicos a acessarem o datamart diretamente, o que garante que os diferentes tipos de método de acesso tenham os mesmos dados.
O Reporting web service é gerenciado pelos servidores front-end do Exchange Server no datacenter, o que tem alguns efeitos importantes: um é quando o acesso ao email está desativado, os relatórios, geralmente, estão desativados. Além disso, o Exchange Server tem proteção de largura de banda de rede na forma de "limitação" de resposta que às vezes pode afetar o Reporting web service. Mas é improvável que você seja afetado por isso, a menos que solicite vários relatórios detalhados muito rapidamente.
O documento de descrição do serviço e o relatório de MailFilterList
O serviço Web de Relatório usa as opções de assinatura da organização, definições de configuração e permissões do usuário para controlar o acesso aos relatórios e as opções disponíveis neles.
Os aplicativos que acessam o Reporting web service precisam fazer duas solicitações iniciais do serviço Web. A primeira é o documento de descrição de serviço, relatório.svc. Esse documento XML informa ao aplicativo quais relatórios o usuário autenticado tem permissão para acessar. Se um relatório for apresentado no documento relatório.svc, o usuário poderá acessá-lo. Para obter mais detalhes, confira Documento do Office 365 relatórios web service reporting.svc.
A segunda solicitação do aplicativo, em geral, recupera o relatório de MailFilterList, o que é crucial para o funcionamento de aplicativos personalizados. O relatório de MailFilterList fornece várias categorias de valores de cadeia de caracteres que devem ser usadas com os outros relatórios. Para obter mais detalhes, confira Relatório de MailFilterList.
Relatórios disponíveis no Serviço Web de Relatório
A tabela a seguir descreve os relatórios disponíveis no serviço Web. Relatórios do Exchange disponíveis no serviço de web de relatório do Office 365 e Serviço web do Lync relatórios disponíveis no relatório do Office 365 fornecem informações completas.
Relatório |
Descrição |
|---|---|
Relatórios de ConnectionbyClientType * |
O número e os tipos de métodos de acesso para cliente do email utilizado pelos usuários da organização durante o período do relatório. Por exemplo, Outlook Web Access, serviços Web do Exchange e assim por diante. |
O número de usuários do Lync Online conectados e ativos durante o período do relatório |
|
Relatórios de CsAVConferenceTime * |
O tempo que os usuários conectados da organização participaram de conferências do Lync Online durante o período do relatório |
A contagem de conferências do Lync Online e sessões peer-to-peer durante o período do relatório. |
|
Grupos de usuários do Office 365 criados e excluídos, resumidos de acordo com os períodos de tempo indicados. |
|
Relatórios de MailboxActivity * |
Os usuários do Office 365 criados e excluídos, resumidos de acordo com os períodos de tempo indicados. Às vezes, a replicação de Active Directory Domain Services (AD DS) pode atrasar essa informação em até um dia. |
Relatório de uso de caixa postal: |
Resumo e estatísticas detalhadas sobre as caixas de correio de usuários da organização. |
Embora esteja presente no documento de serviço, essa opção não retornará nenhum dado, por isso não a chame. |
|
Os detalhes sobre as mensagens que acionaram as regras da política de Prevenção Contra Perda de Dados (DLP). |
|
Mensagens contendo malware detectadas em emails de entrada e saída. |
|
Mensagens contendo spam detectadas em email de entrada e saída. |
|
Regras de transporte do Exchange Server que foram usadas no processamento de mensagens de email individuais. |
|
As constantes de cadeias de caracteres usadas como opção ao solicitar outros relatórios. |
|
Mensagens que dispararam regras de políticas de DLP. |
|
Quantos emails são enviados e recebidos de domínios de fora da organização. |
|
Uma ampla seleção de relatórios listando os principais usuários, eventos, malwares detectados e assim por diante. |
|
Quais usuários enviaram e receberam mais mensagens. |
|
Passo a passo e histórico detalhado de como um email específico foi transferido por meio dos sistemas do Office 365, para ajudar a diagnosticar problemas de entrega. |
|
Retorna as configurações atuais e o status dos registros DNS mailer-exchange (MX). |
|
Relatório de OutboundConnectorReport |
Informações sobre as configurações atuais e o status dos conectores de email de saída (enviadas) definidas pela organização. |
Os detalhes e contagens resumidas de caixas de correio que não foram acessadas no intervalo de tempo indicado. |