Integrar Dynatrace com a autenticação OAuth

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

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 Dynatrace 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çãoDynatrace 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 Dynatrace, defina as configurações de integração.
   1. Navegar até Configurações > Integração > Notificações de problema > Configurando as notificações.
   2. No formulário Configurar integração personalizada, URL do webhook.

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

   3. Habilite Usar OAuth 2.0 para autenticação.
   4. Na seção Credenciais do OAuth 2.0, execute as etapas a seguir.
      1. Forneça a URL do token de acesso como https://<instance_name> .service-now.com/oauth_token.do .
      2. Forneça o valor do ID do cliente com o ID do cliente da entidade OAuth criado na instância ServiceNow.
      3. Forneça "Segredo do cliente" com o segredo do cliente da entidade OAuth criado na instância ServiceNow.
      4. Selecione Salvar.
   5. Na seção Carga personalizada, adicione a seguinte estrutura de carga para os eventos que serão gerados.

      { 
        "ImpactedEntities": {ImpactedEntities}, 
        "ImpactedEntity": "{ImpactedEntity}", 
        "PID": "{PID}", 
        "ProblemDetailsHTML": "{ProblemDetailsHTML}", 
        "ProblemDetailsJSONv2": "{ProblemDetailsJSONv2}",  
        "ProblemDetailsMarkdown": "{ProblemDetailsMarkdown}", 
        "ProblemDetailsText": "{ProblemDetailsText}", 
        "ProblemID": "{ProblemID}", 
        "ProblemImpact": "{ProblemImpact}", 
        "ProblemSeverity": "{ProblemSeverity}", 
        "ProblemTitle": "{ProblemTitle}", 
        "ProblemURL": "{ProblemURL}", 
        "State": "{State}", 
        "Tags": "{Tags}" 
      } 
      

Resultado

Os alertas começam a fluir dos agentes Dynatrace para o plug-in Gestão de eventos. O plug-in extrai informações da mensagem de alerta Dynatrace 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 Dynatrace 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 Dynatrace - Geral. Para obter mais informações sobre regras de evento, consulte Regras de evento.