Chamar relatórios de diagnóstico (por usuário) em Skype for Business Server

Artigo
07/21/2023

Os Relatórios de Diagnóstico de Chamada oferecem informações por usuário sobre falhas em sessões ponto a ponto e de conferência. Neste momento, há apenas um relatório, o Relatório de Atividades do Usuário.

O Relatório de Atividades do Usuário oferece uma lista detalhada das sessões ponto a ponto e de conferência realizadas pelos usuários em um determinado período. Diferente de muitos dos Relatórios de Monitoramento, o Relatório de Atividades do Usuário vincula cada chamada a usuários individuais. Por exemplo, as sessões ponto a ponto especificam URIs do SIP da pessoa que iniciou a chamada (o usuário de origem) e a pessoa que está sendo chamada (o usuário de destino). Se as informações forem ampliadas para uma conferência, será possível ver uma lista de todos os participantes da conferência e a função que desempenham na conferência.

O Relatório de Atividades do Usuário é referenciado algumas vezes como o relatório do "suporte técnico". Isso se deve ao fato de o relatório ser sempre usado pela equipe do suporte técnico para recuperar informações sobre a sessão para um usuário específico. É possível filtrar chamadas feitas para ou por um usuário individual simplesmente digitando o URI do SIP do usuário na caixa URI do usuário.

Se você fizer isso, o Relatório de Atividades do Usuário retornará informações para qualquer usuário cujo URI SIP começa com a cadeia de caracteres especificada. Por exemplo, se você digitar ken na caixa URI, o Relatório de Atividade do Usuário localizará Ken.Myer@litwareinc.com. No entanto, ele localizará também esses usuários:

Kenazi@litwareinc.com
Kenburg@litwareinc.com
Ken.Sanchez@litwareinc.com
Kennedy@litwareinc.com

Para garantir que as informações somente para Ken Myer sejam retornadas, digite seu URI completo (Ken.Myer@litwareinc.com) na caixa de pesquisa ou pelo menos o tipo suficiente do URI de Ken para distingui-lo exclusivamente de outros usuários em sua organização. Por exemplo:

Ken.my

Para acessar o Relatório de Atividades do Usuário

O Relatório de Atividades do Usuário é acessado pela home page dos Relatórios de Monitoramento. Você também pode acessar o Relatório de Atividades do Usuário clicando na métrica URI do usuário no Relatório de Inventário de Telefone IP no Skype for Business Server. No Relatório de Atividades do Usuário, ao clicar em URI da Conferência (para uma conferência), você será levado para o Relatório Detalhado de Conferências. Da mesma forma, clicar na métrica Detalhe de uma chamada ponto a ponto leva você ao Relatório de Detalhes da Sessão Ponto a Ponto em Skype for Business Server.

Fazendo o melhor uso do relatório de atividades do usuário

Embora haja muitas informações relevantes no Relatório de Atividades do Usuário, essas informações podem, por vezes, ser difíceis de localizar. Por exemplo, todas as atividades de usuário que ocorrem em sua organização durante um período especificado estão incluídas no Relatório de Atividades do Usuário; isso significa que, enterrado, no relatório há informações sobre quais usuários realmente usaram Skype for Business Server de alguma forma.

Nota

Tecnicamente, é possível que alguma atividade do usuário não seja registrada: enquanto Skype for Business Server se esforça para manter informações sobre todas as chamadas telefônicas, é possível que uma chamada possa ter sido feita sem que as informações sobre essa chamada sejam gravadas no banco de dados. Skype for Business Server foi projetado para dar uma olhada extremamente precisa, mas não necessariamente perfeita, em como Skype for Business Server está sendo usada. (O fato de não haver garantia de que 100% de todas as chamadas sejam registradas explica por que Skype for Business Server monitoramento não deve ser usado como um sistema de cobrança.) Em segundo lugar, um Relatório de Monitoramento só pode exibir, no máximo, 1.000 registros. Dependendo da quantidade de usuários que você tem e também de período com o qual está trabalhado, isso significa que sua consulta pode não retornar todos os dados realmente armazenados no banco de dados.

Quais usuários usaram realmente o sistema durante este período?
Quais dentre meus usuários foram os mais ativos durante este período?
Os usuários que fazem a maioria das chamadas são também aqueles que participam da maioria das sessões de mensagens instantâneas?

Se precisar responder a essas perguntas, será possível exportar os dados recuperados pelos Relatórios de Monitoramento para uma planilha do Excel. Utilize essa planilha e/ou um arquivo de valores separados por vírgulas para analisar os dados como faz o Relatório de Atividades do Usuário. Por exemplo, suponha que os dados do relatório tenham sido exportados para o Excel e depois para um arquivo de valores separados por vírgulas. Nesse ponto, você pode importar os dados do arquivo .CSV para Windows PowerShell usando um comando semelhante a este:

$x = Import-Csv -Path "C:\Data\User_Activity_Report.csv"

Depois que os dados forem importados, você poderá usar comandos Windows PowerShell simples para ajudar a responder suas perguntas. Por exemplo, este comando retorna uma lista de usuários exclusivos que atuaram como "usuário de origem" em pelo menos uma sessão:

$x | Group-Object "From user" | Select Name | Sort-Object Name

Em outras palavras:

Name
----
David.Ahs@litwareinc.com
Gilead.Amosnino@litwareinc.com
Henrik.Jensen@litwareinc.com
Ken.Myer@litwareinc.com
Pilar.Ackerman@litwareinc.com

Este comando lista os usuários exclusivos (com base no número total de sessões das quais participaram:

$x | Group-Object "From user" | Select Count, Name | Sort-Object Count -Descending

Este retorna dados semelhantes a estes:

Count    Name
-----    ----
  523    Ken.Myer@litwareinc.com
   63    David.Ahs@litwareinc.com
   29    Pilar.Ackerman@litwareinc.com
   17    Gilead.Amosnino@litwareinc.com
   10    Henrik.Jensen@litwareinc.com

Este comando limita as sessões reportadas àquelas que incluíram áudio como modalidade:

$x | Where-Object {$_.Modalities -match "audio"} | Group-Object "From user" | Select Count, Name | Sort-Object Count -Descending

Se você pousar o mouse sobre qualquer ID do diagnóstico mostrado no relatório, uma dica de ferramenta será exibida descrevendo o ID.

Filtros

Os filtros oferecem uma forma de retornar um conjunto de dados mais direcionado ou exibir os dados devolvidos em formas diferentes. Por exemplo, o Relatório de Atividades do Usuário permite filtrar os dados retornados com base em coisas como tipo de atividade (ou seja, sessões ponto a ponto ou sessões de conferência) ou pelo endereço SIP do usuário (permitindo que você exiba as atividades para um usuário). Você também pode escolher como os dados serão agrupados. Nesse caso, os usos são agrupados por hora, dia, semana ou mês.

A tabela a seguir lista os filtros que você pode usar com o Relatório de Atividades do Usuário.

Filtros do relatório de atividades do usuário

Nome	Descrição
De	Data/hora de início para o intervalo de tempo. Para ver os dados por horas, insira a data e hora de início conforme segue: 17/7/12015 13:00 Se você não inserir a hora de início, o relatório começará automaticamente à meia-noite do dia especificado. Para ver os dados por dia, insira somente a data: 17/7/2015 Para exibir por semana ou mês, insira uma data dentro da semana ou mês que deseja exibir (não é necessário inserir o primeiro dia da semana ou mês): 13/7/2015 As semanas sempre vão de domingo a sábado.
Até	Data/hora final de intervalo de tempo. Para ver os dados por horas, insira a data e hora final conforme segue: 17/7/12015 13:00 Se você não inserir a hora final, o relatório terminará automaticamente à meia-noite do dia especificado. Para ver os dados por dia, insira somente a data: 17/7/2015 Para exibir por semana ou mês, insira uma data dentro da semana ou mês que deseja exibir (não é necessário inserir o primeiro dia da semana ou mês): 13/7/2015 As semanas sempre vão de domingo a sábado.
Tipo de atividade	Tipo de atividade. Selecione uma das seguintes opções: [Todos] Ponto a ponto Conferência
Modalidade	A Modalidade disponível para você varia de acordo com o Tipo de Atividade selecionado. Se o Tipo de Atividade for ponto a ponto, você poderá selecionar IM; Transferência de Arquivo; Compartilhamento de aplicativos; Voz; ou Vídeo como a modalidade. Se o Tipo de Atividade for Conferência, você poderá selecionar conferência Telefônica de Mensagem Instantânea; conferência da Web; Compartilhamento de Aplicativos; conferência de Voz/Vídeo; ou conferência Telefônica.
Categoria da sessão	Indica se a atividade em questão teve sucesso ou falhou. Selecione uma das seguintes opções: [Todos] Sucesso Falha esperada Falha inesperada Uma "falha esperada" é uma falha prevista; por exemplo, se um usuário configurou seu status para Não Perturbe, é previsto que qualquer chamada para ele irá falhar. Uma "falha inesperada" ocorre em um sistema que parecia saudável. Por exemplo, uma chamada não deve ser finalizada se o chamador for colocado em espera. Se isso ocorrer, isso seria sinalizado como uma falha inesperada.
Prefixo de URI do usuário	Endereço SIP para o usuário. Para exibir registros somente para o usuário Ken Myer, digite o endereço SIP de Ken Myer. Por exemplo: Sip:kenmyer@litwareinc.com

Métricas para sessões ponto a ponto

A tabela a seguir lista as informações fornecidas no Relatório de Atividades do Usuário para a sessões ponto a ponto (isto é, as que envolvem apenas dois participantes).

Métricas para sessões ponto a ponto

Nome	Você pode classificar este item?	Descrição
Detalhe	Não	Quando você clica neste item, é mostrado o Relatório de Detalhes de Sessão Ponto a Ponto para a sessão selecionada.
Usuário "De"	Sim	Endereço SIP do usuário que iniciou a sessão ponto a ponto.
Usuário "Para"	Sim	Endereço SIP do usuário que entrou na sessão ponto a ponto.
Modalidades	Sim	Tipo de comunicação usado na sessão. Por exemplo, IM, áudio ou transferência de arquivo.
Hora do convite	Sim	Data e hora em que o convite inicial para entrar na sessão ponto a ponto foi enviado.
Hora da resposta	Sim	Data e hora em que o usuário "Para" aceitou o convite para a sessão.
Hora final	Sim	Data e hora em que a sessão ponto a ponto terminou.
ID do Diagnóstico	Sim	Identificador exclusivo (na forma de cabeçalho ms-diagnostics) anexado a uma mensagem SIP que fornece informações úteis para solucionar erros. Os cabeçalhos de diagnóstico são opcionais (é possível ter sessões SIP que não os incluem), e as IDs de diagnóstico são relatadas somente em sessões com algum tipo de problema.

Métricas para sessões de conferência

A tabela a seguir lista as informações fornecidas no Relatório de Atividades do Usuário para a sessões de conferência (isto é, as que envolvem três ou mais participantes).

Métricas para sessões de conferência

Nome	Você pode classificar este item?	Descrição
URI de Conferência	Sim	Identificador exclusivo da conferência. Quando você clica neste item, é mostrado o Relatório de Detalhes da Conferência para a sessão selecionada. Quando você expande esse item, o relatório mostra as informações sobre os participantes. Para obter os detalhes, consulte "Métricas para participantes da conferência", mais adiante neste tópico.
Organizador	Sim	Endereço SIP do usuário que organizou a conferência.
Pool	Sim	Nome do Servidor de Borda (se houver) usado na conferência.
Hora inicial	Sim	Data e hora em que a conferência começou.
Hora final	Sim	Data e hora em que a conferência terminou.

Métricas para participantes da conferência

A tabela a seguir lista as informações fornecidas no Relatório de Atividades do Usuário para cada participante de uma conferência.

Métricas para participantes da conferência

Nome	Você pode classificar este item?	Descrição
Função	Não	Função do usuário na conferência (por exemplo, Apresentador).
Participante	Não	Endereço SIP do usuário.
Conectividade	Não	Tipo de conexão da rede. Por exemplo, "De Interno" para conexão interna ou "De PSTN" os usuários discados.
Hora da ingresso	Não	Data e hora em que o usuário entrou na conferência.
Hora da saída	Não	Data e hora em que o usuário saiu da conferência.
ID do Diagnóstico	Não	Identificador exclusivo (na forma de cabeçalho ms-diagnostics) anexado a uma mensagem SIP que fornece informações úteis para solucionar erros. Os cabeçalhos de diagnóstico são opcionais (é possível ter sessões SIP que não os incluem), e as IDs de diagnóstico são relatadas somente em sessões com algum tipo de problema.