Integrar Datadog com a autenticação OAuth

Integre Datadog com Gestão de eventos autenticando Datadog tokens V1 ou V2 no Monitor Datadog.

Antes de Iniciar

Certifique-se de que o plug-in Gestão de eventos Connectors (sn_em_connector) esteja instalado na instância Now Platform.

O plug-in Gestão de eventos deve ser instalado na instância Now Platform.

Verifique se os itens de configuração dos hosts gerenciados por Datadog existem em ServiceNow. Esses ICs podem ser físicos ou virtuais e podem ser criados manualmente ou descobertos usando a Descoberta de IP ou a Descoberta na nuvem.

Função necessária: evt_mgmt_integration

Por Que e Quando Desempenhar Esta Tarefa

A integraçãoDatadog com a autenticação OAuth está disponível a partir da versão da plataforma Washington DC ou posterior.

Procedimento

1. Configuração na instância ServiceNow.
   1. Crie a propriedade do sistema glide.oauth.inbound.client.credential.grant_type.enabled para usar o tipo de concessão de credenciais do cliente para integrações de entrada do OAuth.
      • Tipo: verdadeiro|falso
      • Valor: verdadeiro
   2. Crie um endpoint de entidade OAuth para que os clientes acessem a instância.
      1. Navegar até Todos > OAuth de Sistema > Registro de aplicações e selecione Novo.
      2. Na página do interceptador, selecione Criar um endpoint de API OAuth para clientes externos e preencha o formulário.
      3. Para criar um registro de cliente OAuth, selecione Enviar.
   3. Adicione o usuário da aplicação OAuth e o tipo de concessão padrão ao registro de cliente OAuth criado.
      1. No formulário Entidade OAuth, adicione os campos Usuário da aplicação OAuth e Tipo de concessão padrão para usar o tipo de concessão de credenciais do cliente para integrações de entrada do OAuth.
      2. Abra o registro de cliente OAuth criado.
      3. No cabeçalho da página, selecione o ícone Mais opções.
      4. Selecionar Configurar > Layout do formulário
      5. Na página Layout do formulário, adicione Usuário da aplicação OAuth e Tipo de concessão padrão na lista de campos.
      6. Salve ou atualize o formulário.
      7. No campo Usuário da aplicação OAuth, selecione o usuário.
         O usuário deve ter a função evt_mgmt_integration que será usada para criar os eventos enviados por Dynatrace.

         Nota:

         Para garantir a autenticação apropriada, use o usuário com menos privilégios com a função evt_mgmt_integration, em vez de um usuário com privilégios altos.
      8. Defina o valor do campo Tipo de concessão padrão como Credenciais do cliente.
      9. Defina Authscope como useraccount.
   4. Criar escopo de autenticação de REST API para Conectores de eventos RestAPI.
      1. Navegar até Todos > Serviços web do sistema > Escopos de autenticação da API > Escopo de autenticação da REST API.
      2. Forneça um nome.
      3. Defina Ativo= verdadeiro.
      4. Defina Authscope como useraccount.
      5. Defina REST API como Conectores de eventos.
      6. Selecione Aplicar escopo de autenticação a todos os métodos HTTP nesta API.
      7. Selecione Aplicar escopo de autenticação a todas as versões nesta API.
      8. Selecione Aplicar escopo de autenticação a todos os recursos nesta API.
2. No console Datadog, adicione marcadores de provedor de nuvem.
   1. Navegar até Menu > Infraestrutura > Lista de infraestrutura.
   2. Selecione Inspecionar para a VM na qual o agente Datadog está instalado.
   3. Selecione Editar marcadores e adicione o marcador cloud_provider.

      O marcador deve ser sufixado com o valor de aws, azure ou gcp para identificar as opções de provedor AWS, Microsoft Azure ou Google Cloud Platform (GCP). Por exemplo: cloud_provider:aws.

   4. Selecione Salvar marcadores.
      Nota:

      Datadog adiciona o marcador cloud_provider por padrão quando a integração do Azure e do Google é instalada no agente Datadog. Os marcadores também podem ser adicionados no nível do provedor de nuvem. Datadog coleta todos os marcadores definidos no nível da VM na nuvem.
3. No console Datadog, adicione um webhook.
   1. Navegar até Menu > Integração > Integrações e pesquise webhooks.
   2. No bloco do webhook, selecione Configurar.
   3. Selecione a guia Métodos de autenticação e escolha Novo método de autenticação.
   4. Insira o nome e selecione o protocolo como OAuth 2.0 Client Credentials.
   5. Forneça a URL do token de acesso como https://<instance_name> .service-now.com/oauth_token.do .
   6. Forneça o valor do ID do cliente com o ID do cliente da entidade OAuth criado na instância ServiceNow.
   7. Forneça "Segredo do cliente" com o segredo do cliente da entidade OAuth criado na instância ServiceNow.
   8. Selecione Salvar.
   9. Criar URL do webhook como

      https://<instance-name> .service-now.com/api/sn_em_connector/em/inbound_event?source=datadog

   10. Selecione o Método OAuth criado nas etapas anteriores no menu suspenso AuthMethod.
   11. Adicione a seguinte estrutura de carga.

       { 
           "body": "$EVENT_MSG", 
           "last_updated": "$LAST_UPDATED", 
           "event_type": "$EVENT_TYPE", 
           "title": "$EVENT_TITLE", 
           "date": "$DATE", 
           "org": { 
               "id": "$ORG_ID", 
               "name": "$ORG_NAME" 
           }, 
           "id": "$ID", 
           "alert_id": "$ALERT_ID", 
           "alert_metric": "$ALERT_METRIC", 
           "metric_namespace": "$METRIC_NAMESPACE",
           "alert_priority": "$ALERT_PRIORITY", 
           "alert_transition": "$ALERT_TRANSITION", 
           "alert_status": "$ALERT_STATUS", 
           "alert_title": "$ALERT_TITLE", 
           "alert_type": "$ALERT_TYPE", 
           "host_name": "$HOSTNAME", 
           "priority": "$PRIORITY", 
           "tags": "$TAGS", 
           "alert_scope": "$ALERT_SCOPE" 
       }  
       

Resultado

Os alertas começam a fluir dos agentes Datadog para o plug-in Gestão de eventos. O plug-in extrai informações da mensagem de alerta Datadog original para preencher os campos de evento obrigatórios e insere o evento no banco de dados. Em sua instância Now Platform, navegue até Todos Eventos para ver os eventos.

Nota:

Por padrão, a vinculação de host está habilitada para eventos Datadog para provedores (AWS/Azure/GCP). Se todos os hosts no ambiente forem descobertos usando Descoberta na nuvem, fornecendo credenciais e os recursos descobertos estiverem na lista cmdb_ci_vm_object, a vinculação da VM poderá não ocorrer. Para resolver isso, você deve habilitar a regra de evento Datadog - Geral. Para obter mais informações sobre regras de evento, consulte Regras de evento.