Configurar Conector do Service Graph para APIs para Kong Gateway usando a Central do SGC

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 7 min. de leitura

    • Configure trabalhos de importação agendada para inserir dados Kong Gateway no seu Configuration Management Database (CMDB).

    Antes de Iniciar

    Instalar Conector do Service Graph para APIs para Kong Gateway versão 2.0.0 ou posterior do ServiceNow Store. Para ServiceNow Store etapas de instalação, consulte Instale uma aplicação da ServiceNow Store .

    Se estiver configurando a conexão Prometheus, habilite o plug-in Prometheus em Kong Gateway e verifique se todas as credenciais necessárias estão disponíveis. Para saber mais sobre o plug-in Prometheus, consulte Prometeu em Kong Site de documentação do desenvolvedor.

    Função necessária: A tabela a seguir mostra as funções necessárias para cada fase do playbook.
    Tabela 1. Função necessária para cada fase do playbook
    Fase Função
    Pré-requisitos administrador
    Configuração SGC-Admin (sn_cmdb_int_util.sgc_admin) ou admin
    Nota:
    A função de usuário administrador é necessária para executar scripts em segundo plano e fornecer acesso a tabelas globais ao usuário administrador do SGC. Para obter informações sobre as funções de usuário para Conectores do Service Graph, consulte Funções de usuário de Conector do Service Graph.

    Por Que e Quando Desempenhar Esta Tarefa

    O Playbook Experience para conectores de integração é ativado com Central do SGC em Espaço do CMDB. Para configurar o. Central do SGC aplicação, consulte Configuração da Central do SGC e para obter mais informações sobre como interagir com um playbook, consulte Interaja com o Playbook .

    Nota:
    Como alternativa, você pode configurar uma conexão padrão já disponível nas conexões instaladas ou de rascunho em Central do SGC. Ir para Tudo > Conectores do Service Graphe selecione Configuração para o conector no menu. Para saber mais sobre conexões instaladas e de rascunho, consulte Gerenciamento de conexões adicionadas para Conectores do Service Graph em Central do SGC.

    Procedimento

    1. Navegar até Espaços > Espaço do CMDB.
    2. No Espaço do CMDB, selecione Central do SGC.
    3. Na página "Visão geral", selecione Criar conexão.
      Dica:
      Outra opção é selecionar Criar conexão na página "Todas as conexões".
    4. Na janela Criar conexão, selecione o tipo de conector da Kong e selecione Criar conexão.
    5. Conclua os pré-requisitos iniciais ao configurar uma conexão pela primeira vez usando um conector.
      Nota:
      Esta etapa é necessária somente durante a configuração inicial. Consulte Execução de tarefas de configuração inicial ao criar uma conexão na Central do SGC.
    6. Selecione um modelo para o tipo de autenticação para criar uma conexão.
      1. Na fase Configuração do playbook, selecione a atividade Selecionar modelo de alias.
      2. Selecione um tipo de modelo.
        • Autenticação Kong RBAC : Selecione ao usar autenticação baseada em token.
        • Autenticação básica Kong : Selecione ao usar autenticação básica.
    7. Insira os detalhes da conexão e teste a conexão da API para importar dados do Kong Gateway.
      1. Na etapa Configuração do playbook, selecione a atividade Criar e testar conexão.
      2. No formulário, preencha os campos.
        Tabela 2. Formulário "Criar e testar conexão"
        Campo Descrição
        Nome da conexão Nome para identificar o registro de conexão Kong Gateway.
        Nome do host Endereço URL de administrador do servidor da API do Administrador Kong.
        Protocolo Protocolo usado para a conexão que garante comunicação segura entre o cliente e o servidor Kong.
        Substituir porta padrão Porta usada pela API do Administrador Kong.
        Chave de API Segredo de autenticação para se conectar ao Kong Gateway serviço. Este campo aparece somente quando Autenticação Kong RBAC está selecionado em Selecione o modelo de alias atividade.
        Nome de usuário Nome de usuário exigido para autenticar solicitações para a API do Administrador do Gateway Kong. Este campo aparece somente quando Autenticação básica Kong está selecionado em Selecione o modelo de alias atividade.
        Senha Senha associada ao nome de usuário exigida para autenticar solicitações. Este campo aparece somente quando Autenticação básica Kong está selecionado em Selecione o modelo de alias atividade.
      3. Selecione Criar e testar conexão.
      4. Depois de concluir o teste de conexão, selecione Continuar.
    8. Opcional: Defina as propriedades de configuração da conexão.
      1. Na etapa Configuração do playbook, selecione a atividade Definir propriedades de configuração.
      2. Em Expand HTTP Method TypesCampo disponível na seção Configuração de recuperação de dados, insira os métodos HTTP, incluindo OBTER , PUBLICAÇÃO , COLOCAR , PATCH , EXCLUIR , OPÇÕES , CABEÇA , CONECTAR e. RASTREAMENTO , a serem considerados para rotas.
        Para vários métodos, separe-os com vírgulas. Se deixado em branco, um front-end de API único será criado com o. TODOS Método, indicando suporte para todos os métodos HTTP padrão.
      3. Em Exclude workspacesCampo disponível na seção Configurações de propriedade, insira o espaço que deve ser excluído da importação.

        Caso haja vários espaços, separe-os por vírgulas. Por exemplo: espaço1, espaço2. Se você deixar este campo em branco, as fontes de dados no conector importarão dados de todos os espaços.

      4. Selecione Marcadores de importação caixa de seleção disponível na seção de configurações de marcador para ingerir marcadores do Kong Gateway serviço.
        Quando selecionado, especifique o separador de par de chave-valor para marcadores no Separador de valor de marcadores campo. Se não for selecionado, os marcadores não serão obtidos.
      5. Em Separador de valor de marcadores campo disponível na seção de configurações de marcador, insira o separador de chave e valor nos marcadores.
        Por exemplo, se o separador de valor do marcador estiver definido como . , o marcador prod salvo com env como a chave e. prod como o valor.

        Se deixado em branco, nenhum marcador será ingerido.

      6. Selecione Coletar dados de uso Caixa de seleção disponível na seção Configurações de métrica para habilitar a coleta de dados de uso para recuperar dados de uso da API em uma duração especificada.
      7. Em Período de coleta (em dias) Campo disponível na seção Configurações de métrica, insira a duração em dias para coletar dados de uso da API.
      8. Selecione Continuar.
    9. Opcional: Insira Prometeu Detalhes da conexão e teste a conexão da API para importação Kong Gateway Dados de métricas usando o plug-in Prometheus.
      Nota:
      Você pode ignorar esta etapa se o monitoramento do uso da API com o Prometheus não for necessário ou se estiver usando uma instância do Prometheus existente. Para ignorar esta etapa, selecione Pular para Criar e testar conexão Prometheus atividade.
      1. Em Configuração do playbook, selecione Criar e testar conexão Prometheus atividade.
      2. No formulário, preencha os campos.
        Tabela 3. Criar e testar Prometeu Formulário de conexão
        Campo Descrição
        Nome da conexão Nome para identificar o. Prometeu registro de conexão.
        URL de conexão URL base do Prometeu API HTTP, usada para buscar métricas.
        Nome de usuário Nome de usuário necessário para autenticar solicitações para Prometeu servidor.
        Senha Senha associada ao nome de usuário necessário para autenticar solicitações para Prometeu servidor.
      3. Selecione Criar e testar conexão.
      4. Depois de concluir o teste de conexão, selecione Continuar.
    10. Opcional: Associe a conexão Prometheus a um Kong Gateway conexão.
      Nota:
      Você pode ignorar esta etapa se o monitoramento do uso da API com o Prometheus não for necessário. Para ignorar esta etapa, selecione Pular para Kong Mapeamento Prometheus atividade.
      1. Em Configuração do playbook, selecione Kong Mapeamento Prometheus atividade.
      2. Em Conexões Prometheus , pesquise e selecione uma conexão Prometheus para associar.
        Você pode selecionar a conexão Prometheus criada na etapa 9 Ou selecione qualquer conexão Prometheus existente durante esta etapa. Se você pular a etapa 9, Selecione qualquer conexão Prometheus existente.
      3. Selecione Enviar.
      Uma conexão Prometheus pode ser associada a vários Kong Gateway conexões. Você pode atualizar o mapeamento do Prometheus no Kong Gateway conexão do Central do SGC exibir a qualquer momento. Consulte Atualize uma conexão para um Conector do Service Graph em Central do SGC.
    11. Configure o cronograma de importação para importar dados em intervalos regulares.
      1. Na fase Configuração do playbook, selecione a atividade Configurar cronograma de importação.
      2. Selecione Configurar cronograma de importação.
      3. Expanda a importação de dados agendada primária na lista Agendamentos de importação para selecionar Gateway SG-Kong programação de importação associada à sua conexão.
        Nota:
        O nome da conexão é prefixado ao nome da programação.
      4. Na caixa de diálogo Configurar cronograma de importação, marque a caixa de seleção Ativo e, em seguida, preencha os detalhes do cronograma de execução e do horário.

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

      5. Selecione Salvar.
        Como alternativa, selecione Executar agora para executar a programação de importação imediatamente.
      6. Selecione Continuar.
    12. Na etapa Configuração do playbook, selecione a atividade Confirmar criação de conexão para verificar se a conexão foi configurada.

    O que Fazer Depois

    Selecione Exibir todas as conexões para analisar os detalhes da conexão. As conexões configuradas, incluindo Kong Gateway A conexão e a conexão Prometheus, se criadas, aparecem na lista Conexões instaladas.

    Em seguida, você pode gerenciar conexões do Central do SGC exibição do Espaço do CMDB. Para obter mais informações, consulte Gerenciamento de conexões adicionadas para Conectores do Service Graph em Central do SGC.