Como configurar o Conector do Service Graph para Observability - Dynatrace

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 16 min. de leitura
  • Use Conector do Service Graph para Observability - Dynatrace para ingerir dados Configuration Management Database (CMDB) de Dynatrace usando REST APIs. Este conector é a segunda geração da aplicação Conector do Service Graph para Observability - Dynatrace desenvolvida por ServiceNow.

    Antes de Iniciar

    Para usar este Conector do Service Graph, você precisa de uma assinatura para uma Unidade de Assinatura baseada na aplicação Visibilidade IT Operations Management (ITOM) ou na aplicação Descoberta ITOM. Conforme definido na seção intitulada "Tipos de recurso de TI gerenciados" em Visão geral da unidade de assinatura da ServiceNow, para sua assinatura, para recursos de TI gerenciados criados ou modificados em CMDB por este Conector do Service Graph, mas que ainda não são gerenciados pela Visibilidade do ITOM ou pela Descoberta do ITOM, esses recursos aumentarão o consumo da Unidade de Assinatura dessa aplicação. Analise o consumo atual da unidade de assinatura na Visibilidade do ITOM ou no ITOM Discovery para garantir a capacidade disponível.

    Dependências e requisitos:
    • A aplicação da Store Componentes comuns de integração para CMDB, que é instalado automaticamente.
    • O app da Store dos Modelos de classe de IC do CMDB, que é instalado automaticamente. Consulte Modelos de classe de IC do CMDB.
    • O plug-in de licença da Descoberta do ITOM (com.snc.itom.discovery.license). Você deve ativar este plug-in.
    • Plug-in de licenciamento do ITOM (com.snc.itom.license). Para obter mais informações, consulte Solicitação da Descoberta.
    • O plug-in Datastream Action (com.glide.hub.action_type.datastream), que é instalado automaticamente.
    • Base para observabilidade para CMDB (sn_observability), que só é necessário para a ingestão de eventos e precisará ser instalado antes de instalar o conector para que o Event Management funcione. Para obter mais informações, confira Base para observabilidade para CMDB em ServiceNow Store.
    Nota:
    Para acessar a API Dynatrace, você precisa de um token de acesso com o escopo Ler entidades (entities.read).

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Conectores do Service Graph > Observabilidade da Dynatrace > Configuração.
    2. Na página de Introdução, selecione Introdução.
    3. Defina valores de impacto para clusters e faça com que o conector obtenha acesso à API SNC.ImpactManager.
      Nota:
      Esta etapa aparece quando a Base para observabilidade é instalada.
      1. Na página Configuração, em Habilitar acesso ao SNC.Impact Manager, selecione a tarefa Copiar script para escopo global.
      2. Na seção Copiar script para escopo global, copie o script.
        1. Selecione Configurar.
        2. Alterne para o escopo global.
        3. Selecione o ícone Ações adicionais (Ícone Ações adicionais).
        4. Selecione Inserir e permanecer.
        5. Selecione Marcar como concluído.
      3. Na seção Verificar se o script foi copiado corretamente, verifique o script.
        1. Selecione Configurar.
        2. Selecione o script EvtMgmtImpactManagerMediator e verifique se ele foi copiado para o escopo global.
        3. No campo Acessível de, verifique se ele está definido como Todos os escopos da aplicação.
        4. Selecione Marcar como concluído.
    4. Defina a configuração básica.
      1. Na página Configuração, na seção Básica, selecione a tarefa Configurar token de autenticação para o Dynatrace.
      2. Na próxima página, na seção Configurar token de autenticação para o Dynatrace, configure o token de autenticação.
        1. Selecione Configurar.
        2. No campo Chave de API, insira api-token <seu token de API>.

          Por exemplo, api-token ID_do_meu_token.

        3. Selecione Marcar como concluído.
      3. Na seçao Configurar conexão HTTP para o Dynatrace, configure a conexão HTTP.
        1. Selecione Configurar.
        2. Atualize o campo Host com um nome de host totalmente qualificado para sua instância do Dynatrace.

          Por exemplo, abc123.live.dynatrace.com.

          O nome do host será preenchido automaticamente no campo URL da conexão.

        3. Habilite o uso de um MID Server e marque a caixa de seleção Usar MID Server.
          Nota:
          A conexão HTTP será pré-configurada para usar a chave de API configurada durante a tarefa de configuração anterior.
        4. Selecione Marcar como concluído.
      4. Teste a conexão HTTP.
        1. Na seção Testar conexão, selecione Configurar.
        2. Para testar a configuração da conexão, selecione Testar conexão.
          Nota:
          Se algum dos testes apresentar algum erro, siga as sugestões de correção.
        3. Defina a tarefa Testar conexão como concluída clicando em Marcar como concluída.
      5. Na seção Criar modelo de carga de notificação padrão, selecione Configurar.
        Nota:
        Você precisa de um token de acesso com os seguintes escopos:
        • Configuração de leitura (ReadConfig)
        • Configuração de escrita (WriteConfig)
        • Logs de leitura (LogExport)
        • Métricas de leitura (metrics.read)
        • Ler configurações (settings.read)
        • Configurações de gravação (settings.write)
        • Ler logs (logs.read)
        1. Atualize o nome do modelo de carga, se necessário.
        2. Selecione Configuração de notificação de problemas.
        3. Defina a tarefa Criar modelo de carga útil de notificação padrão para concluir selecionando Marcar como concluído.
      6. Opcional: Se você quiser oferecer suporte a várias instâncias, na seção Fazer o upgrade de chaves nativas de origem, clique em Configurar.
        1. Alterne para o escopo global.
        2. Insira o script a seguir.
          var gr = new GlideRecord("sys_object_source");
          gr.addQuery("name", "SGO-Dynatrace");
          var grOR = gr.addQuery("id", "STARTSWITH", "HOST-");
          grOR.addOrCondition("id", "STARTSWITH", "PROCESS_GROUP_INSTANCE-");
          grOR.addOrCondition("id", "STARTSWITH", "PROCESS_GROUP-");
          grOR.addOrCondition("id", "STARTSWITH", "SERVICE-");
          grOR.addOrCondition("id", "STARTSWITH", "APPLICATION-");
          gr.query();
          while (gr.next()) {
              gr.setValue("id", "f379137e075820107add6a77c4a93538|||" + gr.getValue("id"));
              gr.update();
          }
        3. Selecione Executar script.
        4. No menu Escopo, selecione Conector do Service Graph para observabilidade do Dynatrace, depois escolha Marcar como concluído.
    5. Para um locatário habilitado para o Grail, configure as credenciais do cliente do OAuth 2.0 e teste a conexão.
      Para obter mais informações sobre Dynatrace credenciais do OAuth, consulte Autenticação da API de gestão de contas no site de documentação Dynatrace.
      1. Defina o status do Dynatrace Grail para indicar se está usando o locatário habilitado para o Grail.
        Nota:

        Você pode verificar a ativação do Grail entrando em contato com o administrador Dynatrace.

        1. Na seção Configurar OAuth para o Dynatrace Grail da página de Configuração do Conector do Service Graph para observabilidade do Dynatrace, selecione Introdução.
        2. Para a tarefa Definir status do Dynatrace Grail, selecione Configurar e revise ou modifique as configurações de propriedade de um locatário habilitado para o Grail.
        3. Se você tiver um locatário habilitado para o Grail, defina o campo Valor da propriedade grailEnabled como verdadeiro.

          Além disso, defina o valor como falso.

        4. Defina a tarefa Configurar o OAuth do Dynatrace Grail como concluída clicando em Marcar como concluída.
      2. Adicione uma nova conexão para o OAuth.
        Nota:
        Você precisa de um token do OAuth com as seguintes permissões de escopo no Grail:
        • storage:logs:read
        • storage:buckets:read
        1. Na seção Configurar credenciais do OAuth, clique em Configurar.
        2. Na página do Workflow Studio que é aberta em uma nova guia do navegador, selecione Adicionar conexão.
        3. Insira um nome, o URL de conexão, o ID do cliente para o OAuth e os detalhes confidenciais do cliente para o OAuth.
        4. Selecione Criar e obter um Token do OAuth.
        5. Retorne à página de configuração assistida.
        6. Defina a tarefa Configurar as credenciais do OAuth como concluída, clicando em Marcar como concluída.
      3. Teste as novas conexões para o OAuth.
        1. Na seção Testar conexão, selecione Configurar.
        2. Para testar a configuração da conexão, selecione Testar conexão.
        3. Quando o campo Status estiver definido como Êxito, selecione Atualizar para fechar a caixa de diálogo Testar a conexão e voltar à página de configuração assistida.

          Se algum dos testes apresentar algum erro, siga as sugestões de correção.

        4. Defina a tarefa Testar conexão como concluída clicando em Marcar como concluída.
    6. Definir as configurações adicionais.
      1. Na página Configuração assistida, na seção Avançada, selecione a tarefa Configurações avançadas.
      2. Na seção Configurações avançadas, selecione Configurar e revise ou modifique as configurações existentes para uma configuração personalizada.
        Você pode definir as seguintes configurações:
        • Revise o tamanho da página usado em solicitações de REST API para buscar entidades da Dynatrace.
        • Defina o número de dias que um item de configuração (IC) pode ficar inativo antes de ser ignorado.
        • Insira a porcentagem de nós de cluster da aplicação que precisam estar em um estado para elevar esse estado ao do primário no mapa de serviço.

          Por exemplo, você pode definir a porcentagem de nós que precisam se tornar críticos para que o primário de um cluster esteja em um estado crítico. Se houver 10 nós em um cluster, definir o valor da propriedade como 70 exigirá que pelo menos 7 dos 10 nós no cluster entrem em um estado crítico para refletir o serviço primário do cluster.

        • Habilite a ingestão de eventos que não tenham um IC correspondente no CMDB.
        • Habilite o preenchimento de ICs da aplicação (cmdb_ci_appl) do Dynatrace (processos da Dynatrace) durante as importações programadas.
      3. Selecione Salvar.
      4. Selecione Marcar como concluído para a tarefa de Configurações avançadas.
      5. Configure propriedades de conexão da Dynatrace.
        1. Na seção Configurar instância Configurações, selecione Configurar.
        2. Na lista relacionada Propriedades do Service Graph Connector, configure as propriedades do registro de conexão.
          Tabela 1. Propriedades de conexão do Dynatrace
          Propriedade Descrição
          managementZoneNames Insira o nome da zona de gestão para buscar no seu ambiente Dynatrace. Para várias entradas, separe os nomes das zonas por vírgulas.
          marcadores Insira o nome dos marcadores para buscar no seu ambiente da Dynatrace. Para várias entradas, separe os marcadores com vírgulas.
          serviceTypes Insira a lista de Dynatrace tipos de serviço de onde ingerir os dados em CMDB. Para várias entradas, separe os tipos de serviço por vírgulas.
          Nota:
          Todos os tipos de serviço, exceto DATABASE_SERVICE, são mapeados para a tabela Serviço de aplicações calculado [cmdb_ci_service_calculated] do CMDB. O tipo de serviço DATABASE_SERVICE é mapeado para a tabela Instância de banco de dados [cmdb_ci_db_instance] do CMDB.

          Os valores válidos são:

          • BACKGROUND_ACTIVITY
          • CICS_SERVICE
          • CUSTOM_SERVICE
          • DATABASE_SERVICE
          • ENTERPRISE_SERVICE_BUS_SERVICE
          • EXTERNO
          • IBM_INTEGRATION_BUS_SERVICE
          • IMS_SERVICE
          • MESSAGING_SERVICE
          • QUEUE_LISTENER_SERVICE
          • RMI_SERVICE
          • RPC_SERVICE
          • WEB_REQUEST_SERVICE
          • WEB_SERVICE
          managementZoneIds Insira o nome da ID da zona de gerenciamento a ser buscada no seu ambiente Dynatrace. Para várias entradas, separe os IDs de zona com vírgulas.
        3. Selecione Atualizar.
        4. Conclua a tarefa Definir configurações da instância clicando em Marcar como concluída.
      6. Execute o script de correção Fix Older Ids para migrar os IDs dos dados importados do formato anterior para o formato mais recente dos IDs de objeto.
        Nota:
        A partir da versão 1.9.0 do Conector do Service Graph para Observability - Dynatrace, o formato mais recente dos IDs de objeto, que é a codificação Base64, é usado para importação de dados. O script de correção Fix Older Ids migra todos os dados existentes com IDs de objeto anteriores para o formato mais recente.
      7. Definir configurações de notificações.

        A configuração permite transferir eventos de ITOM da instância Dynatrace para a ServiceNow.

        1. Na seção Configurar notificação de problemas, selecione Configurar.
        2. Para enviar a configuração por push ao Dynatrace, selecione Configuração de notificação de problemas.
        3. Para receber a configuração do Dynatrace, selecione Buscar configuração de notificação.
        4. Conclua a tarefa Configurar notificação de problema clicando em Marcar como concluída.
    7. Limpar registros da instância anterior.
      Nota:
      Se você não estiver migrando da versão anterior do Dynatrace, poderá ignorar esta etapa.
      1. Na página Configuração, na seção Limpar registros da integração anterior, selecione a tarefa Executar a nova integração.
      2. Na próxima página, na seção "Executar a nova integração", selecione Configurar e depois Executar.
      3. Selecione Marcar como concluído.
      4. Na seção Verificar se a execução da integração foi concluída, verifique a execução da integração.
        1. Selecione Configurar.
        2. No campo Estado, aguarde até que o campo mude para Concluído ou Concluído com erros.

          É normal haver erros durante a migração de uma versão mais antiga.

        3. Para atualizar a lista, clique com o botão direito do mouse no cabeçalho e selecione Atualizar lista.
        4. Selecione Marcar como concluído.
      5. Na seção Excluir serviços de aplicações restantes da versão anterior, selecione Configurar para excluir todos os serviços de aplicações de que você não precisa mais da integração anterior.
      6. Selecione Marcar como concluído.
      7. Na seção Remanescentes de Identificação de Limpeza - Copiar Script, copie o script.
        1. Selecione Configurar.
        2. Altere o escopo atual para Global.
        3. Clique no ícone de menu (Ícone de menu).
        4. Selecione Inserir e permanecer.
        5. Selecione Marcar como concluído.
      8. Na seção Remanescentes de Identificação de Limpeza - Executar Script, execute o script.
        1. Selecione Configurar.
        2. Selecione o registro do script que você copiou.
        3. Selecione Atualizar.
    8. Opcional: Adicionar várias instâncias.
      Nota:
      Se você não precisar adicionar várias instâncias, poderá ignorar esta etapa.
      1. Na seção Adicionar várias instâncias da página Conector do Service Graph para Microsoft Defender, selecione Primeiros passos.
      2. Atualize o acesso à fonte de dados para criar uma fonte de dados para a nova conexão.
        1. Verifique se você tem permissões de edição para a tabela Fonte de dados [sys_data_source].
        2. Na tarefa Atualizar acesso à fonte de dados, selecione Configurar.
        3. Para editar o registro, selecione o escopo da aplicação Global no seletor de aplicações.
        4. Na lista relacionada de Acesso à Aplicação no formulário de Fonte de Dados que abre em uma nova guia, selecione as caixas de seleção Pode criar, Pode atualizar e Pode excluir.
        5. Selecione Atualizar para voltar à página de configuração assistida.
        6. A partir do seletor de aplicações, selecione o escopo da aplicação como Conector do Service Graph para observabilidade do Dynatrace.
        7. Defina a tarefa Atualizar acesso de fontes de dados como concluída selecionando Marcar como concluída.
      3. Atualize o acesso à importação de dados programada para criar uma importação programada para a nova conexão.
        1. Verifique se você tem permissões de edição para a tabela Importação de dados programada [scheduled_import_set].
        2. Na tarefa Atualizar acesso à Importação de dados programada, selecione Configurar.
        3. Para editar o registro, selecione o escopo da aplicação Global no seletor de aplicação.
        4. Na lista relacionada de Acesso à Aplicação no formulário de Fonte de Dados que abre em uma nova guia, selecione as caixas de seleção Pode criar, Pode atualizar e Pode excluir.
        5. Selecione Atualizar para voltar à página de configuração assistida.
        6. A partir do seletor de aplicações, selecione o escopo da aplicação como Conector do Service Graph para observabilidade do Dynatrace.
        7. Defina a tarefa Atualizar acesso de importação de dados programados como concluída selecionando Marcar como concluída.
      4. Atualize o acesso ao valor para criar uma fonte de dados para a nova conexão.
        1. Verifique se você tem permissões de edição para a tabela Valor [sys_variable_value].
        2. Na tarefa Atualizar acesso ao valor, selecione Configurar.
        3. Para editar o registro, selecione o escopo da aplicação Global no seletor de aplicação.
        4. Na lista relacionada de Acesso à Aplicação no formulário de Fonte de Dados que abre em uma nova guia, selecione as caixas de seleção Pode criar, Pode atualizar e Pode excluir.
        5. Selecione Atualizar para voltar à página de configuração assistida.
        6. A partir do seletor de aplicações, selecione o escopo da aplicação como Conector do Service Graph para observabilidade do Dynatrace.
        7. Defina a tarefa Atualizar acesso ao valor como concluída selecionando Marcar como concluída.
      5. Limpe a fonte de dados e o cache de conjunto para importação para a nova conexão.
        1. Para a opção Limpar cache para fonte de dados e conjunto para importação, escolha Configurar.
        2. Para editar o registro, selecione o escopo da aplicação Global no seletor de aplicação.
        3. No campo Executar o programa (JavaScript executado no servidor), indique o seguinte script:
          
                GlideTableManager.invalidateTable("sys_data_source");
                GlideCacheManager.flushTable("sys_data_source");
          
                GlideTableManager.invalidateTable("scheduled_import_set");
                GlideCacheManager.flushTable("scheduled_import_set");
          
                GlideTableManager.invalidateTable("sys_variable_value");
                GlideCacheManager.flushTable("sys_variable_value");
          
                GlideTableManager.invalidateTable("sys_db_object");
                GlideCacheManager.flushTable("sys_db_object");
        4. Selecione Executar script.
        5. A partir do seletor de aplicações, selecione o escopo da aplicação como Conector do Service Graph para observabilidade do Dynatrace.
        6. Defina a tarefa Limpar cache de fontes de dados e conjuntos de importações como completa selecionando Marcar como completa.
      6. Adicionar outra conexão.
        1. Verifique se o escopo da aplicação está definido como o Conector do Service Graph para observabilidade no seletor de aplicações.
        2. Para a tarefa Adicionar outra conexão, selecione Configurar.
        3. Na página do Workflow Studio que é aberta em uma nova guia do navegador, selecione Adicionar conexão.
        4. No formulário, preencha os campos.
          Tabela 2. Formulário de conexão
          Campo Descrição
          Nome da conexão Nome de exibição da conexão.
          Nome de host de conexão Nome de host da instância do Dynatrace.
          Chave de API Chave de API do Dynatrace.
          Nota:
          A Chave de API deve ter o prefixo api-token.
        5. Selecione Criar conexão.
        6. Retorne à página de configuração assistida.
        7. Defina a tarefa Adicionar outra conexão como concluída clicando em Marcar como concluída.
      7. Se estiver usando um locatário habilitado para Grail, configure conexões para o OAuth 2.0 adicionais.
        1. Para a tarefa Adicionar outra conexão para o OAuth, selecione Configurar.
        2. Na página do Workflow Studio que é aberta em uma nova guia do navegador, selecione Adicionar conexão.
        3. Insira um nome, o URL de conexão, o ID do cliente para o OAuth e os detalhes confidenciais do cliente para o OAuth.
        4. Selecione Criar e obter um Token do OAuth.
        5. Retorne à página de configuração assistida.
        6. Defina a tarefa Adicionar outra conexão para o OAuth como concluída clicando em Marcar como concluída.
      8. Se estiver usando um locatário habilitado para Grail, selecione o alias de credenciais do cliente do OAuth 2.0 criado anteriormente na tarefa Adicionar outra conexão para o OAuth.
        1. Para a tarefa Criar link para registro de conexão com credenciais de cliente do OAuth, selecione Configurar.
        2. No campo Alias de conexão e credenciais do OAuth 2.0, pesquise e selecione o alias de conexão do OAuth que você criou na etapa 8.g.
        3. No registro de conexão do Service Graph, pesquise e selecione o registro de conexão que você criou na etapa 8.f.
        4. Selecione Enviar.
        5. Retorne à página de configuração assistida.
        6. Defina a tarefa Criar link para o registro de conexão com as credenciais de cliente do OAuth como concluída, clicando em Marcar como concluída.
      9. Opcional: Configure o MID Server para a conexão criada.
        1. Para a tarefa Configurar MID Servers, selecione Configurar.
        2. Selecione o nome da conexão criada.
        3. Marque a caixa de seleção Usar MID Server.
        4. Selecione Atualizar.
        5. Defina a tarefa Configurar MID Servers como concluída, clicando em Marcar como concluída.
      10. Defina as configurações da instância.
        1. Na seção Configurar instâncias, selecione Configurar.
        2. Selecione o nome da conexão que deseja configurar e, então, clique em Atualizar.
        3. Defina a tarefa Configurar instâncias como concluída, clicando em Marcar como concluída.
      11. Teste as novas conexões.
        1. Para a tarefa Testar conexão, selecione Configurar.
        2. Selecione o nome da conexão que deseja testar.
        3. Para validar a configuração da fonte de dados, clique em Testar carga de 20 registros.
        4. Quando o campo Status estiver definido como Êxito, selecione Atualizar para fechar a caixa de diálogo Testar a conexão e voltar à página de configuração assistida.

          Se algum dos testes apresentar algum erro, siga as sugestões de correção.

        5. Defina a tarefa Testar conexão como concluída clicando em Marcar como concluída.
      12. Criar modelos de carga de notificação padrão.
        1. Verifique se você tem o token de acesso com os seguintes escopos:
          • Configuração de leitura (ReadConfig)
          • Configuração de escrita (WriteConfig)
          • Logs de leitura (LogExport)
          • Métricas de leitura (metrics.read)
        2. Na seção Criar modelos de carga de notificação padrão, selecione Configurar.
        3. Selecione a conexão para a qual deseja criar um modelo de carga de notificação padrão.
        4. Atualize o nome do modelo de carga, se necessário.
        5. Selecione Configuração de notificação de problemas.
          A notificação é criada com os parâmetros de carga conforme descrito na tabela a seguir.
          Tabela 3. Parâmetros da carga de notificação
          Parâmetro Descrição
          nome Nome da notificação. O nome é automaticamente prefixado com Notificação de problema padrão da ServiceNow e o nome da instância é adicionado a ele.
          alertingProfile ID do perfil de alerta na Dynatrace.
          tipo Tipo de carga que é definido automaticamente como webhook.
          url URL do webhook no formato https://https://<instance name>.service-now.com/ /api/sn_em_connector/em/inbound_event?source=SGO-Dynatrace.
          carga Carga personalizada criada para notificação no seguinte formato:
          {  
          
            "ImpactedEntities": {ImpactedEntities},  
          
            "ImpactedEntity": "{ImpactedEntity}",  
          
            "PID": "{PID}",  
          
            "ProblemDetailsHTML": "{ProblemDetailsHTML}",  
          
            "ProblemDetailsJSON": {ProblemDetailsJSON},  
          
            "ProblemDetailsMarkdown": "{ProblemDetailsMarkdown}",  
          
            "ProblemDetailsText": "{ProblemDetailsText}",  
          
            "ProblemID": "{ProblemID}",  
          
            "ProblemImpact": "{ProblemImpact}",  
          
            "ProblemSeverity": "{ProblemSeverity}",  
          
            "ProblemTitle": "{ProblemTitle}",  
          
            "ProblemURL": "{ProblemURL}",  
          
            "State": "{State}",  
          
            "Tags": "{Tags}"  
          
          } 
        6. Repita as etapas para cada conexão.
        7. Defina a tarefa Criar modelo de carga útil de notificação padrão para concluir selecionando Marcar como concluído.
    9. Configurar trabalhos de importação programada.
      1. Na seção Configurar trabalhos de importação programados da página Conector do Service Graph para Microsoft Defender, selecione a tarefa Introdução.
      2. Para a tarefa Configurar importações programadas, selecione Configurar.
      3. Selecione o nome da importação programada que você deseja executar.
      4. No formulário "Importação de dados programada", verifique os valores de campos referentes ao trabalho agendado e marque a caixa de seleção Ativo.

        Para obter mais informações, consulte Schedule a data import.

      5. Selecione Atualizar.
      6. Defina a tarefa Configurar trabalhos de importações programadas como concluída selecionando Marcar como concluído.