Habilitar logs de recursos para Hubs de Notificação

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

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

Esquema de logs de recursos

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

• AzureActivity: Exibe logs de operações e ações realizadas em 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 em seu namespace usando a API ou por meio de clientes de gerenciamento no SDK de linguagem.

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

Aqui está um exemplo de uma cadeia de caracteres JSON de 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 callerIdentity campo pode estar vazio ou uma cadeia de caracteres JSON com um dos seguintes formatos.

Para chamadas originadas do 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 identity campo contém o nome de usuário do usuário conectado.

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

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

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

Eventos e operações capturados em logs operacionais

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

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 são desabilitados por padrão. Para habilitar os logs, faça o seguinte:

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

   

2. No painel Configurações de diagnóstico, selecione Adicionar configuração de diagnóstico.

   

3. Configure as configurações de diagnóstico fazendo o seguinte:

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

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

   • Se você selecionar Enviar para o espaço de trabalho do Log Analytics, precisará especificar para qual instância do Log Analytics o diagnóstico será enviado.
   • Se você selecionar Arquivar em uma conta de armazenamento, precisará configurar a conta de armazenamento onde os logs de diagnóstico serão armazenados.
   • Se você selecionar Transmitir para um hub de eventos, precisará configurar o hub de eventos para o qual deseja transmitir os logs de diagnóstico.

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

   

4. Selecione Guardar.

As novas configurações entram em vigor em cerca de 10 minutos. Os logs são exibidos no destino de arquivamento configurado, no painel Logs de diagnóstico.

Conteúdos relacionados

Para saber mais sobre como definir configurações de diagnóstico, consulte:

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

Para saber mais sobre os Hubs de Notificação do Azure, consulte:

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