Integrar logs de serviço OSDU com o Azure Monitor

O Azure Data Manager for Energy dá suporte à exportação de Logs de Serviço OSDU para o Azure Monitor usando uma configuração de diagnóstico. Este recurso ajuda você a solucionar melhor problemas, depurar, & monitorar os serviços OSDU. As instruções aqui são semelhantes à forma como você integraria outros logs, como Airflow e Elastic, com o Azure Monitor.

Pré-requisitos

  • Um espaço de trabalho existente do Log Analytics. Este espaço de trabalho é usado para consultar logs de serviço OSDU usando o editor de consultas KQL (Kusto Query Language) no espaço de trabalho do Log Analytics. Recurso útil: crie um espaço de trabalho de análise de log no portal do Azure.

  • Uma conta de armazenamento existente: é usada para armazenar dumps JSON de logs de serviço OSDU. A conta de armazenamento não tem de estar na mesma subscrição da área de trabalho do Log Analytics.

Ativando configurações de diagnóstico para integração de logs de serviço OSDU

  1. Abra a página Visão geral do Microsoft Azure Data Manager for Energy.

  2. Selecione Configurações de diagnóstico no painel esquerdo.

    Screenshot shows that the list of OSDU services currently supported is visible on the diagnostic settings overview page.

  3. Selecione Adicionar definição de diagnóstico. Escolha um nome de configuração de diagnóstico e selecione os serviços em Categorias para os quais você deseja enviar logs para o destino escolhido.

    Screenshot to show that users can select all or a few log categories while creating a diagnostic setting.

  4. Na seção Logs, você pode escolher um ou vários serviços OSDU para os quais deseja criar uma configuração de diagnóstico. Selecione Arquivar em uma conta de armazenamento e/ou Enviar para o espaço de trabalho do Log Analytics conforme desejado.

    Screenshot shows that export to multiple destinations can be configured with just one diagnostic setting.

  5. Verifique a assinatura, a conta de armazenamento e o espaço de trabalho do Log Analytics no qual você deseja arquivar os logs ou integrar-se.

Trabalhando com logs de serviço OSDU no espaço de trabalho do Log Analytics

  1. Navegue até a guia Logs no painel esquerdo.

  2. Expanda a lista de tabelas na categoria Gerenciamento de Logs. Os logs de serviço OSDU exportados usando uma configuração de diagnóstico aparecem na tabela OEPDataplaneLogs .

  3. Mover para o painel do editor. Aqui, você pode escrever consultas Kusto Query Language (KQL) para filtrar seus logs de serviço OSDU e exibir apenas os relevantes.

    Screenshot shows the different parts of a Log Analytics workspace interface.

Solução de problemas com logs de serviço OSDU

A análise de logs de serviço OSDU no Azure Monitor pode ajudá-lo a identificar erros e problemas relacionados a serviços e APIs específicos. Examine os logs de serviços como o Serviço de Fluxo de Trabalho, o Serviço de Partição ou o Serviço de Direitos para identificar e resolver rapidamente quaisquer problemas nas chamadas de API ou na funcionalidade do serviço.

O editor de consultas do Log Analytics Workspace suporta consultas KQL. Aqui estão alguns exemplos de consultas que podem ser úteis:

  • Uma consulta para filtrar os logs de serviço OSDU gerados por um serviço específico no Azure Data Manager for Energy nas últimas 6 horas.
OEPDataplaneLogs
| where TimeGenerated >= ago(6h)
| where _ResourceID contains "name-of-your-adme-instance"
| where Category = "DatasetLogs"
  • Uma consulta para filtrar logs para todas as chamadas de serviço OSDU que resultaram em erros hoje.
OEPDataplaneLogs
| where _ResourceID contains "name-of-your-adme-instance"
| where TimeGenerated >= startofday(ago(0d))
| where TimeGenerated < startofday(ago(-1d))
| where LogLevel != "INFO"

Arquivamento de logs de serviço OSDU em contas de armazenamento

Você pode arquivar logs de serviço OSDU em contas de armazenamento e aproveitar os recursos do Azure Monitor para arquivamento de logs, políticas de retenção e muito mais:

  • Especifique a conta de armazenamento para arquivar logs durante o processo de criação da configuração de diagnóstico.
  • Defina políticas de retenção para os logs arquivados.
  • Acesse os logs na conta de armazenamento para outras análises ou armazenamento de longo prazo.

Próximos passos

Agora que você está coletando logs de serviço OSDU, crie um alerta de consulta de log para ser notificado proativamente quando dados interessantes forem identificados em seus dados de log.