Compartilhar via

Logs de chat dos Serviços de Comunicação do Azure

  • Artigo

Os Serviços de Comunicação do Azure oferecem funcionalidades de log que você pode usar para monitorar e depurar sua solução dos Serviços de Comunicação. Essas funcionalidades podem ser configuradas por meio do portal do Azure.

Importante

O exemplo a seguir refere-se aos logs habilitados por meio do Azure Monitor (confira também as perguntas frequentes). Para habilitar esses logs para os Serviços de Comunicações, confira: Habilitar o registro em log nas Configurações de Diagnóstico

Categorias de log de recursos

Os Serviços de Comunicação seguintes tipos de logs que você pode habilitar:

  • Logs de uso: fornecem dados de uso associados a cada oferta de serviço cobrada
  • Logs operacionais de autenticação – fornece informações básicas relacionadas ao serviço de Autenticação
  • Logs operacionais de chat: fornecem informações básicas relacionadas ao serviço de chat

Esquema de logs de uso

Propriedade Descrição
Timestamp O carimbo de data/hora (UTC) de quando o log foi gerado.
Operation Name A operação associada ao registro de log.
Operation Version A api-version associada à operação, caso a operationName tenha sido executada com uma API. Se não houver nenhuma API que corresponda a essa operação, a versão representará a versão dessa operação, caso as propriedades associadas à operação sejam alteradas no futuro.
Category A categoria de log do evento. Categoria é a granularidade na qual você pode habilitar ou desabilitar os logs em determinado recurso. As propriedades exibidas no blob de propriedades de um evento são as mesmas em uma categoria de log e um tipo de recurso específicos.
Correlation ID A ID de eventos correlacionados. Pode ser usada para identificar os eventos correlacionados entre várias tabelas.
Properties Outros dados aplicáveis a vários modos dos Serviços de Comunicação.
Record ID A ID exclusiva de um registro de uso especificado.
Usage Type O modo de uso. (por exemplo, chat, PSTN, NAT etc.)
Unit Type O tipo de unidade em que o uso se baseia para um modo de uso especificado. (por exemplo, minutos, megabytes, mensagens etc.).
Quantity O número de unidades usadas ou consumidas para este registro.

Logs operacionais de autenticação

Propriedade Descrição
TimeGenerated O carimbo de data/hora (UTC) de quando o log foi gerado.
OperationName A operação associada ao registro de log.
CorrelationID A ID de eventos correlacionados. Pode ser usada para identificar os eventos correlacionados entre várias tabelas.
OperationVersion A api-version associada à operação, caso o operationName tenha sido executado com uma API. Se não houver nenhuma API que corresponda a essa operação, a versão representará a versão dessa operação, caso as propriedades associadas à operação sejam alteradas no futuro.
Category A categoria de log do evento. Categoria é a granularidade na qual você pode habilitar ou desabilitar os logs em determinado recurso. As propriedades exibidas no blob de propriedades de um evento são as mesmas em uma categoria de log e um tipo de recurso específicos.
ResultType O status da operação.
ResultSignature O substatus da operação. Se essa operação corresponder a uma chamada à API REST, esse campo será o código de status HTTP da chamada REST correspondente.
DurationMs A duração da operação em milissegundos.
CallerIpAddress O endereço IP do chamador, caso a operação corresponda a uma chamada à API proveniente de uma entidade com um endereço IP disponível publicamente.
Level O nível de severidade do evento.
URI O URI da solicitação.
SdkType O tipo de SDK usado na solicitação.
PlatformType O tipo de plataforma usado na solicitação.
Identity A identidade do usuário do Serviços de Comunicação do Azure ou do Teams relacionada à operação.
Scopes Os escopos dos Serviços de Comunicação presentes no token de acesso.

Logs operacionais de chat

Propriedade Descrição
TimeGenerated O carimbo de data/hora (UTC) de quando o log foi gerado.
OperationName A operação associada ao registro de log.
CorrelationID A ID de eventos correlacionados. Pode ser usada para identificar os eventos correlacionados entre várias tabelas.
OperationVersion A api-version associada à operação, caso a operationName tenha sido executada com uma API. Se não houver nenhuma API que corresponda a essa operação, a versão representará a versão dessa operação, caso as propriedades associadas à operação sejam alteradas no futuro.
Categoria A categoria de log do evento. Categoria é a granularidade na qual você pode habilitar ou desabilitar os logs em determinado recurso. As propriedades exibidas no blob de propriedades de um evento são as mesmas em uma categoria de log e um tipo de recurso específicos.
ResultType O status da operação.
ResultSignature O substatus da operação. Se essa operação corresponder a uma chamada à API REST, esse campo será o código de status HTTP da chamada REST correspondente.
ResultDescription A descrição de texto estático desta operação.
DurationMs A duração da operação em milissegundos.
CallerIpAddress O endereço IP do chamador, caso a operação corresponda a uma chamada à API proveniente de uma entidade com um endereço IP disponível publicamente.
Nível O nível de severidade do evento.
URI O URI da solicitação.
UserId A ID de usuário do remetente da solicitação.
ChatThreadId A ID do thread de chat associado à solicitação.
ChatMessageId A ID da mensagem de chat associada à solicitação.
SdkType O tipo de SDK usado na solicitação.
PlatformType O tipo de plataforma usado na solicitação.