Habilitar logs de recursos para Hubs de Notificação

Ao começar a usar o namespace dos Hubs de Notificações do Microsoft Azure, convém monitorar como e quando o namespace é criado, excluído ou acessado. Este artigo fornece uma visão geral de todos os logs de atividade e de diagnóstico que estão disponíveis.

Atualmente, os Hubs de Notificações do Microsoft Azure dão suporte a atividades e logs operacionais, que capturam operações de gerenciamento executadas no namespace dos Hubs de Notificações do Microsoft Azure.

Esquema de logs de recursos

Todos os logs são armazenados no formato JavaScript Object Notation (JSON) nos dois locais a seguir:

• AzureActivity: exibe logs de operações e ações que são realizadas no seu namespace no portal do Azure ou por meio de implantações de modelo do Azure Resource Manager.
• AzureDiagnostics: exibe logs de operações e ações que são conduzidas no seu namespace usando a API, ou através de clientes de gerenciamento no SDK de linguagem.

Para obter uma lista de elementos incluídos nas cadeias de caracteres de log de diagnóstico, consulte as Tabelas de logs do Azure Monitor.

Este é um exemplo de uma cadeia de caracteres JSON do log operacional:

{
    "operationName": "Microsoft.NotificationHubs/Namespaces/NotificationHubs/authorizationRules/action",
    "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/SAMPLES/PROVIDERS/MICROSOFT.NOTIFICATIONHUBS/NAMESPACES/SAMPLE-NS",
    "time": "1/1/2021 5:16:32 AM +00:00",
    "category": "OperationalLogs",
    "resultType": "Succeeded",
    "resultDescription": "Gets Hub Authorization Rules",
    "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
    "callerIdentity": "{ \"identityType\": \"Portal\", \"identity\": \"\" }"
}

O campo callerIdentity pode estar vazio ou uma cadeia de caracteres JSON com um dos formatos a seguir.

Para chamadas originadas no portal do Azure, o identity campo está vazio. O log pode ser correlacionado aos logs de atividades para determinar o usuário conectado.

{
    "identityType": "Portal",
    "identity": ""
}

Para chamadas feitas por meio do Azure Resource Manager, o campo identity contém o nome de usuário conectado.

{
   "identityType": "Username",
   "identity": "test@foo.com"
}

Para chamadas à API REST dos Hubs de Notificação, o campo identity contém o nome da política de acesso usada para gerar o token SharedAccessSignature.

{
   "identityType": "KeyName",
   "identity": "SharedAccessRootKey2"
}

Eventos e operações capturados nos logs de diagnóstico

Os logs operacionais capturam todas as operações de gerenciamento executadas no namespace dos Hubs de Notificações do Microsoft Azure. Operações de dados não são capturadas devido ao alto volume de operações de dados que são realizadas nos hubs de notificações.

Para obter uma lista das operações de gerenciamento capturadas em logs operacionais, consulte Operações do provedor de recursos Microsoft.NotificationHubs.

Habilitar logs operacionais

Os logs operacionais estão desabilitados por padrão. Para habilitar os logs, faça o seguinte:

1. No portal do Azure, acesse o namespace dos Hubs de Notificações do Microsoft Azure e, em Monitoramento, selecione Configurações de diagnóstico.

   

2. Na página Configurações de diagnóstico, selecione Adicionar configuração de diagnóstico.

   

3. Defina as configurações de diagnóstico realizando as seguintes etapas:

   a. Na caixa Nome, insira um nome para as configurações de diagnóstico.

   b. Selecione um dos seguintes três destinos para seus logs de diagnóstico:

   • Se você selecionar Enviar para o workspace do Log Analytics, especifique para qual instância do Log Analytics o diagnóstico será enviado.
   • Se você selecionar Arquivar em uma conta de armazenamento, configure a conta de armazenamento em que os logs de diagnóstico serão armazenados.
   • Se você selecionar Transmitir para um hub de eventos, configure o hub de eventos para o qual você deseja transmitir os logs de diagnóstico.

   c. Selecione a caixa de seleção OperationalLogs.

   

4. Selecione Salvar.

As novas configurações terão efeito em aproximadamente dez minutos. Os logs aparecerão no destino de arquivamento configurado, no painel Logs de diagnóstico.

Conteúdo relacionado

Para saber mais sobre as configurações de diagnóstico, confira:

• Visão geral do log de diagnóstico do Azure.

Para saber mais sobre os Hubs de Notificações do Microsoft Azure, confira:

• O que são Hubs de Notificação do Azure?