Como configurar o Service Graph Connector for Observability – Datadog

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 5 min. de leitura

    • Extraia dados do Datadog para o seu CMDB.

    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 ingestão de eventos. Ele deve ser instalado antes de instalar o conector para que a gestão de eventos funcione. Para obter mais informações, confira Base para observabilidade para CMDB em ServiceNow Store.
    Nota:
    Se você tiver uma versão anterior do Service Graph Connector for Observability – Datadog, não migre os dados do conector antigo. Você deve desinstalar a versão anterior e executar a nova integração.

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Conectores do Service Graph > Datadog de observabilidade > Configuração.
    2. Na página de Introdução, selecione Introdução.
    3. Configure as credenciais de autenticação e o nome do host para enviar solicitações à API Datadog.
      1. Configure suas credenciais do Datadog.
        1. Na seção Configurar a conexão da página Integração do Datadog ao CMDB, selecione Introdução.
        2. Para a tarefa Configurar as credenciais, selecione Configurar.
        3. No campo Nome, insira um nome para a autenticação.

          Por exemplo, credenciais do Datadog.

        4. No campo Chave de API, insira o token da API do Datadog.
        5. No campo Chave de autenticação, insira a chave de autenticação usada para se conectar à API do Datadog.
        6. Clique em Atualizar.
        7. Defina a tarefa Configurar as credenciais como concluída, clicando em Marcar como Concluída.
      2. Defina as configurações de conexão do Datadog.
        1. Na seção Configurar a Conexão da página Integração do Datadog ao CMDB, selecione Continuar.
        2. Para a tarefa Configurar a conexão, selecione Configurar.
        3. Revise os campos e, no campo Host, insira o URL ou o endereço IP de base do Datadog.
        4. Atualize o campo Protocolo se não estiver usando https.
        5. Deixe o campo Caminho base como está.
        6. Clique em Atualizar.
        7. Defina a tarefa Configurar a Conexão como concluída clicando em Marcar como concluída.

        Para obter mais informações sobre a API Datadog, consulte Datadog Desenvolver documentação.

    4. Configure uma conta de usuário para a Datadog e integração do CMDB.
      1. Crie a Datadog CMDBconta de usuário de integração preenchendo o formulário de Usuário.
        1. Na seção conta de usuário de integração do Datadog ao CMDB da página Integração do Datadog ao CMDB, selecione Introdução.
        2. Para a tarefa Criar um usuário de integração do Datadog ao CMDB, selecione Configurar.
        3. Revise os campos no formulário do Usuário, insira os detalhes da conta do usuário de Datadog CMDBintegração e defina uma senha para a conta do usuário.
        4. Clique em Atualizar.
        5. Defina a tarefa Criar um usuário de integração do Datadog ao CMDB como concluída clicando em Marcar como Concluída.
      2. Atribua a função cmdb_import_api_admin role ao usuário de Datadog CMDBintegração.
        1. Na seção Conta de usuário de integração do Datadog ao CMDB da página Integração do Datadog ao CMDB, selecione Continuar.
        2. Para a tarefa Atribuir função ao usuário do Datadog CMDB, selecione Configurar.
        3. Na coluna ID do Usuário da lista Usuários, selecione o ID do usuário de Datadog CMDBintegração que você criou na etapa anterior 4.a.
        4. Na lista relacionada Funções, clique em Editar.
        5. No formulário Editar membros, mova a função cmdb_import_api_admin das funções disponíveis na coluna Coleção para a coluna Lista de funções.
        6. Clique em Salvar.
        7. Clique em Atualizar.
        8. Defina a tarefa Atribuir função ao usuário do Datadog CMDB como concluída clicando em Marcar como Concluída.
    5. Configure o bloco ServiceNow no Datadog e habilite a Datadog CMDBintegração.
      1. Configure o bloco ServiceNow no Datadog.
        1. Faça login na sua conta Datadog.
        2. Selecione a guia Integrações.
        3. Pesquise e selecione o bloco ServiceNow.
        4. Adicione o nome da instância ServiceNow no formato https://<instance name> .service-now.com/.
        5. Adicione o nome e a senha da conta de usuário de Datadog CMDBIntegração e clique em Enviar.

        Para obter mais informações, consulte Datadog documentação.

        Nota:
        Depois de configurar o bloco ServiceNow no Datadog, na configuração assistida do Service Graph Connector for Observability – Datadog, vá para a seção Configurar bloco do Datadog e permitir a integração da página Integração do Datadog com CMDB e defina o bloco ServiceNow na tarefa do Datadog como concluída clicando em Marcar como Concluída.
      2. Habilite a Datadog CMDBIntegração em sua instância ServiceNow.
        1. Na seção Configurar o bloco Datadog e permitir a integração da página Integração do Datadog ao CMDB, selecione Continuar.
        2. Para a tarefa Habilitar a integração na ServiceNow, selecione Configurar.
        3. No formulário de Propriedade do Sistema, preencha os campos para criar a propriedade do sistema sn_datadog_integra.datadog_enabled e defina o valor como verdadeiro.

          Para obter mais informações, consulte Add a system property.

        4. Clique em Enviar.
        5. Defina a tarefa Habilitar a integração na ServiceNow como concluída clicando em Marcar como concluída.
    6. Configure o webhook e os monitores do ObservabilityDatadog.
      1. Na seção Configurar Observability da página Integração do Datadog ao CMDB, selecione Introdução.
      2. Para a tarefa Configurar os webhooks e monitores, selecione Configurar.
      3. Na lista Webhooks do Datadog, clique em Novo para adicionar um webhook do Datadog.
      4. Preencha os campos.
        Tabela 1. Formulário Novo registro
        Campo Descrição
        Nome Nome do webhook Datadog.
        Alias de Conexão Pesquise e selecione o alias de conexão e credencial criado na etapa 3.
      5. Clique em Enviar.
      6. Preencha a lista de Webhooks do Datadog clicando no link relacionado Sincronizar monitores na página do Webhook do Datadog.
        Nota:
        Na lista de Webhooks do Datadog, não clique em Novo para adicionar um monitor, pois o botão não é usado neste cenário.
      7. Na coluna Nome da lista de Webhooks do Datadog, clique no link para um monitor.
      8. Na página Monitores do Datadog, marque a caixa de seleção Webhook ativo e clique em Atualizar.
      9. Repita as etapas 6.g e 6.h para todos os monitores na lista de Webhooks do Datadog.
      10. Na página Webhook do Datadog, clique em Atualizar para salvar suas mudanças.
      11. Defina a tarefa Configurar webhooks e monitores como concluída clicando em Marcar como concluída.