Como configurar o Conector do Service Graph para observabilidade - Dynatrace

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 11 min. de leitura

    • Use Conector do Service Graph para observabilidade - 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 observabilidade - 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 Visibility IT Operations Management (ITOM) ou na aplicação Discovery ITOM. Conforme definido na seção "Tipos de recursos de TI gerenciados" em Visão geral da unidade de assinatura da ServiceNow para sua assinatura, para recursos de TI gerenciados que são criados ou modificados no CMDB por este Conector do Service Graph, mas que ainda não são gerenciados pela Visibilidade do ITOM ou Descoberta do ITOM, esses recursos aumentarão o consumo da Unidade de assinatura dessa aplicação. Analise o consumo atual da unidade de assinatura no ITOM Visibility ou no ITOM Discovery para garantir a capacidade disponível.

    Dependências e requisitos:
    • A aplicação da Store Integration Commons for CMDB, que é instalado automaticamente.
    • A aplicação da Store Aplicação da Store de CMDB CI Class Models, que é instalada automaticamente.
    • O plug-in do ITOM Discovery License (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 do Discovery.
    • O plug-in Datastream Action (com.glide.hub.action_type.datastream), que é instalado automaticamente.
    • Observability Commons for 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, consulte Observability Commons for CMDB no ServiceNow Store.
    Nota:
    Para acessar a API Dynatrace, você precisa de um token de acesso com escopo Ler entidades (entities.read).

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Service Graph Connectors > 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 o Observability Commons é instalado.
      1. Na página Configuração, na seção 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. Clique em Configurar.
        2. Alterne para o escopo global.
        3. Clique no ícone Ações adicionais ( Ícone Ações adicionais).
        4. Selecione Inserir e permanecer.
        5. Clique em Marcar como concluído.
      3. Na seção Verificar se o script foi copiado corretamente, verifique o script.
        1. Clique em 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. Clique em 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 Dynatrace.
      2. Na próxima página, na seção Configurar token de autenticação para Dynatrace, configure o token de autenticação.
        1. Clique em Configurar.
        2. No campo Chave de API, insira api-token <seu token de API>.

          Por exemplo, api-token ID_do_meu_token.

        3. Clique em Marcar como concluído.
      3. Na seçao Configurar conexão HTTP para Dynatrace, configure a conexão HTTP.
        1. Clique em 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. Clique em Marcar como concluído.
      4. Na seção Testar conexão, para testar a conexão selecione Configurar.
        1. Na seção Testar a conexão, clique em Configurar.
        2. Para testar a configuração da conexão, selecione Testar conexão.
          Nota:
          Se o teste da conexão falhar, há um erro de conexão que você precisa corrigir.
        3. Ao terminar, clique em Marcar como concluído.
      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)
        1. Atualize o nome do modelo de carga, se necessário.
        2. Clique em Configuração de notificação de problemas.
        3. Ao terminar, clique em Marcar como concluído.
      6. Opcional: Se você quiser oferecer suporte a várias instâncias, na seção Atualizar 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 Service Graph Connector for Observability Dynatrace, depois escolha Marcar como concluído.
    5. 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) da Dynatrace (processos da Dynatrace) durante as importações programadas.
      3. Clique em 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 nomes das zonas por vírgulas.
          serviceTypes 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.
          managementZoneIds 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.
        3. Clique em Atualizar.
        4. Conclua a tarefa Definir configurações da instância clicando em Marcar como Concluída.
      6. 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.
    6. 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 escolha Executar agora.
      3. Selecione Marcar como concluído.
      4. Na seção Verificar de a execução da integração foi concluída, verifique a execução da integração.
        1. Clique em 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. Se você precisar atualizar a lista, clique com o botão direito do mouse no cabeçalho e selecione Atualizar lista.
        4. Clique em 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. Clique em Marcar como concluído.
      7. Na seção Remanescentes de Identificação de Limpeza - Copiar Script, copie o script.
        1. Clique em Configurar.
        2. Altere o escopo atual para Global.
        3. Clique no ícone de menu ( Ícone de menu).
        4. Clique em Inserir e permanecer.
        5. Clique em Marcar como concluído.
      8. Na seção Remanescentes de Identificação de Limpeza - Executar Script, execute o script.
        1. Clique em Configurar.
        2. Selecione o registro do script que você copiou.
        3. Clique em Executar Agora.
    7. Opcional: Adicionar várias instâncias.
      Nota:
      Se você não precisar adicionar várias instâncias, poderá ignorar esta etapa.
      1. Na barra lateral esquerda, selecione o ícone Adicionar várias instâncias (Ícone Adicionar várias instâncias).
      2. Na página Service Graph Connector for Observability Dynatrace, na seção Adicionar várias instâncias, selecione a tarefa Atualizar acesso à fonte de dados.
      3. Na próxima página, na seção Atualizar acesso à fonte de dados, selecione Configurar.
      4. Selecione a tabela Fonte de dados [sys_data_source].
      5. Para editar o registro, selecione Global no menu Escopo.
      6. Na guia Acesso à aplicação, marque as caixas de seleção Pode criar, Pode atualizar e Pode excluir.
      7. Salve o registro.
      8. No menu Escopo, selecione Service Graph Connector for Observability Dynatrace.
      9. Na barra de tarefas de Ajuda, clique em Marcar como concluído.
      10. Repita essas etapas na seção Atualizar acesso à importação de dados programada com a tabela Importação de dados programada [Scheduled_data_set] e a seção Atualizar acesso ao valor com a tabela Valor [sys_variable_table].
    8. Limpe o cache da nova conexão.
      1. Selecione a tarefa Limpar cache para fonte de dados e conjunto de importação, depois escolha Configurar.
      2. Limpe o cache selecionando Global no menu Escopo.
      3. Insira o script a seguir. 
        
      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. No menu Escopo, selecione Service Graph Connector for Observability Dynatrace.
      6. Clique em Marcar como concluído.
    9. Adicionar outra conexão.
      Nota:
      Altere o escopo para Service Graph Connector for Observability, caso contrário, você não conseguirá carregar as conexões adicionais.
      1. Na seção Adicionar outra conexão, clique em Configurar.
      2. No Flow Designer, selecione Adicionar conexão.
      3. 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.
      4. Clique em Criar conexão.
      5. Navegue de volta à configuração orientada e clique em Marcar como concluído.
      6. Se necessário, configure o MID Server para a conexão criada.
        1. Na seção Configurar MID Servers, clique em Configurar.
        2. Selecione o nome da conexão criada.
        3. Clique na caixa de seleção Usar MID Server.
        4. Clique em Atualizar.
        5. Ao terminar a tarefa, clique em Marcar como concluído
      7. Defina as configurações da instância.
        1. Na seção Configurar instâncias, clique em Configurar.
        2. Selecione o nome da conexão que deseja configurar.
        3. Ao terminar, clique em Atualizar, depois em Marcar como concluído.
      8. Teste as novas conexões.
        1. Na seção Testar conexões, clique em Configurar.
        2. Selecione o nome da conexão que deseja testar.
        3. Para validar a configuração da fonte de dados, clique no botão Testar carga de 20 registros.
          Nota:
          Se o teste da conexão falhar, há um erro de conexão que você precisa corrigir.
        4. Ao terminar, clique em Marcar como concluído.
      9. Na seção Criar modelos 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)
        1. Selecione a conexão para a qual deseja criar um modelo de carga de notificação padrão.
        2. Atualize o nome do modelo de carga, se necessário.
        3. Clique em 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 de 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 em 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}"  

}
        4. Repita as etapas para cada conexão.
        5. Ao terminar, clique em Marcar como concluído.
    10. Configurar trabalhos de importação programada.
      1. Na página de Configuração, na seção Configurar trabalhos de importação programada, selecione a tarefa Configurar os trabalhos de importação programada.
      2. Na próxima página, selecione Configurar.
      3. No formulário, revise os campos conforme necessário.
        Tabela 4. Formulário de importação de dados programados
        Campo Descrição
        Nome Nome do trabalho programado.
        Fonte de dados Registro de fonte de dados que define os dados a serem importados.
        Executar como Opção para executar o trabalho programado com as credenciais do usuário especificado.
        Ativo Opção de ativar o trabalho programado. Selecione esta opção.
        Importação simultânea Função que carrega os dados de vários Import Sets. A função processa e transforma os dados simultaneamente.
        Método de Partição Método de partição referente ao conjunto de importação simultânea.
        Tamanho da Partição Tamanho do conjunto de importação para programação antecipada.
        Executar script de pré-importação Opção para especificar um script a ser executado antes que a importação seja realizada.
        Executar script de pós-importação Opção para especificar um script a ser executado depois que a importação for realizada.
        Aplicação Aplicação que contém este trabalho programado.
        Executar Frequência de execução da importação. Defina este valor para a frequência com que você deseja extrair seus dados.
        Condicional Condições sob as quais este trabalho é executado.
      4. Selecione as importações que você deseja executar e clique em Executar Agora, depois em Marcar como concluído.