Integrar Dynatrace Com autenticação OAuth

Integrar Dynatrace com Gestão de eventos autenticando Dynatrace Tokens V1 ou V2 no Dynatrace Monitor.

Antes de Iniciar

Certifique-se de que Gestão de eventos O plug-in Conectores (sn_em_connector) está instalado no ServiceNow AI Platform instância.

. Gestão de eventos o plug-in deve ser instalado no ServiceNow AI Platform instância.

Verifique os itens de configuração dos hosts gerenciados por Dynatrace existe 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 de nuvem.

Função necessária: evt_mgmt_integration

Por Que e Quando Desempenhar Esta Tarefa

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

Procedimento

1. Configuração no ServiceNow instância.
   1. Criar glide.oauth.inbound.client.credential.grant_type.enabledPropriedade do sistema para usar o tipo de concessão de Credenciais do cliente para integrações de entrada OAuth.
      • Tipo: verdadeiro|falso
      • Valor: verdadeiro
   2. Crie um endpoint de entidade do OAuth para os clientes acessarem a instância.
      1. Navegar até Tudo > OAuth de Sistema > Registro de aplicações e selecione Novo .
      2. Na página Interceptador, selecione Crie um endpoint da 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 do cliente OAuth criado.
      1. No formulário Entidade OAuth, adicione Usuário da aplicação OAuth e o. Tipo de concessão padrão Campos para usar o tipo de concessão Credenciais do cliente para integrações de entrada OAuth.
      2. Abra o registro do cliente OAuth criado.
      3. No cabeçalho da página, selecione Mais ícone de 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. Salvar ou Atualização o formulário.
      7. Para 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 adequada, use o usuário menos privilegiado com a função evt_mgmt_integration, em vez de um usuário com alto privilégio.
      8. Definido Tipo de concessão padrão valor do campo para Credenciais do cliente .
2. Em Dynatrace console, defina as configurações de integração.
   1. Navegar até Configurações > Integração > Notificações de problemas > 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. Habilitar Use OAuth 2,0 para autenticação .
   4. Na seção de 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 para ID do cliente Com o ID do cliente da entidade OAuth Client criado em ServiceNow instância.
      3. Forneça "Segredo do cliente" com o segredo do cliente do cliente da entidade OAuth criado em ServiceNow instância.
      4. Selecione Save (Salvar).
   5. Na seção Carga personalizada, adicione a seguinte estrutura de carga para os eventos que serão gerados. Certifique-se de que ImpactedEntities e. ProblemDetalhesJSONv2 São passados como objetos JSON, não cadeias de caracteres.

      { 
        "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 de Dynatrace agentes no Gestão de eventos plug-in. O plug-in extrai informações do original Dynatrace mensagem de alerta para preencher os campos de evento obrigatórios e inserir o evento no banco de dados. Em seu ServiceNow AI Platform, navegue até Todos os eventos para ver os eventos.

Nota:

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