Criar e gerenciar mapeamentos de dados

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura
  • Mapeie seus serviços para os dados de uma instância de APM (Application Performance Management, gestão de desempenho de aplicações) externa conectada e exiba-os em gráficos para o serviço e suas entidades relacionadas.

    Antes de Iniciar

    • Se você estiver usando a versão 1,5.0, ative os serviços que têm dados de uma instância de APM externa. Para obter instruções sobre como ativar os serviços, consulte Ativar equipes e serviços. Para versões posteriores, você não precisa ativar serviços. Você pode mapear qualquer um dos seguintes tipos de serviço:
      • Aplicação
      • Aplicação mapeada
      • Aplicação calculada
      • Grupo dinâmico de IC
      • Técnico
      • Baseado em marcador
      • Ofertas de serviço
      • Serviços de negócio
    • Conecte um Observabilidade de serviços fonte de dados

    Função necessária: sn_sow_svcobs.admin

    Por Que e Quando Desempenhar Esta Tarefa

    Quando você mapeia um item de configuração de serviço (IC) para pares de chave/valor de marcador específicos a partir dos metadados de métrica do APM, Observabilidade de serviços exibe todas as métricas com esses marcadores, no contexto desse serviço. Essas métricas são agrupadas pelos seguintes tipos de entidade:
    • Métricas da aplicação: Métricas associadas ao serviço selecionado
    • Métricas de computação: Métricas associadas aos hosts em que o serviço é executado
    • Bancos de dados: Métricas associadas a bancos de dados usados pelo serviço

    Por exemplo, digamos que você tenha métricas de New Relic usados para monitorar serviços, bancos de dados e hosts. Nessas métricas, você usou o marcador service_name . Digamos que você também mapeou o. check-out IC de serviço para o par chave/valor de metadados do APM service_name: check-out . Observabilidade de serviços mostra todas as métricas de host e banco de dados marcadas com service_name: check-out no contexto de check-out IC de serviço.

    Se algumas de suas métricas em entidades diferentes usarem um nome de chave diferente ou um valor de chave diferente, você poderá criar exceções. Por exemplo, se suas métricas de host usarem serviço em vez de service_name , você pode criar uma exceção para incluir essas métricas.

    Cada tipo de entidade tem seu próprio painel e cada métrica e IC relacionado tem seu próprio gráfico padrão. Você pode personalizar os modelos usados para os painéis e gráficos. Para obter mais informações, consulte Personalizar modelos do painel Observabilidade de serviço.

    Nota:
    Para entender como Observabilidade de serviços cria esses mapeamentos, consulte Mapeamentos de entidade do fornecedor do APM para Observabilidade de serviços.

    Para obter uma descrição dos valores dos campos, consulte Observabilidade de serviços formulário de mapeamento de dados.

    Procedimento

    1. Navegue até a página Mapeamentos de dados, seguindo os procedimentos para sua versão do Observabilidade de serviços.
      • Versão 1,5.0: Navegue até Tudo > Espaço de operações de serviços > Configurações, em seguida, navegue até Gestão de observabilidade de serviço > Gerenciar observabilidade > Mapeamentos de dados
      • Versão 1,6.x ou posterior: Navegue até Tudo > Espaço de operações de serviços > Configurações, em seguida, navegue até Observabilidade de serviços > Mapeamentos de dados.
    2. Selecione Crie seu primeiro mapeamento ou Criar mapeamento .
    3. Na página Mapeamento de dados de observabilidade, insira um nome para o mapeamento.
    4. Escolha os serviços que devem usar este mapeamento.
      • Para a versão 1,5.0: Insira os nomes dos serviços ativados que você deseja mapear. Para obter informações sobre como ativar serviços, consulte Ativar equipes e serviços
      • Para a versão 1,6.x e posterior:
        1. Escolha Selecione serviços .
        2. Use a navegação para restringir a lista ao tipo de serviço que você está procurando.
        3. Selecione os serviços a serem adicionados ao mapeamento. Você pode adicionar serviços de qualquer combinação de tipo de serviço.
          Nota:
          Use o filtro para restringir a lista de serviços.
        4. Selecione Adicionar serviços para adicioná-los ao mapeamento.
      O painel de visualização de mapeamento é atualizado para mostrar o serviço selecionado ou o primeiro serviço em uma lista de serviços.
    5. Crie uma regra para determinar como Observabilidade de serviços Os serviços devem ser mapeados para as entidades do APM usando chaves e valores de marcador.
      1. Selecione a fonte de dados para este mapa.
      2. Insira a chave de marcador que você deseja mapear para o serviço ativado.
        A chave pode ser qualquer marcador usado nos metadados do APM, por exemplo serviço .
        Nota:
        Se você usar mais de um marcador para representar um serviço, poderá criar uma exceção. Por exemplo, se a maioria dos marcadores usar service_name exceto para métricas de banco de dados, que usam serviço , você pode criar uma exceção para as métricas do banco de dados.
      3. Insira manualmente um valor de marcador ou escolha um na lista suspensa.
        Os valores podem ser cadeias de caracteres dos metadados do APM, como um nome de serviço, ou podem ser uma variável que você usa nesses dados para representar várias instâncias, por exemplo serviço . Se sua chave representar um serviço, por conveniência, um menu suspenso mostrará campos do IC correspondente para o serviço, incluindo campos personalizados, que podem ser usados como uma variável. Se você optar por usar uma variável, certifique-se de que os valores sejam resolvidos para valores enviados nos dados do APM.
        Nota:
        Se você selecionou mais de um serviço para mapear, o menu suspenso exibirá somente os campos comuns a todos os serviços.
      Agora você pode testar seu mapeamento ou adicionar exceções.
    6. Opcional: Se algumas de suas entidades usarem nomes ou valores de chave diferentes, crie exceções para a política padrão configurando-as no cartão Exceções.
    7. Teste o mapeamento.
      1. Em Visualização de mapeamento , selecione um serviço para testar e selecione Mapeamento de teste .
        Observabilidade de serviços envia uma solicitação por meio da conexão e retorna as entidades encontradas usando o mapeamento fornecido. Se você criou uma exceção usando uma origem diferente, o painel mostrará os resultados de cada origem separadamente.
      2. Verifique se os resultados são os esperados.
        Caso contrário, tente reconfigurar o mapeamento alterando a chave ou o valor do marcador.
      3. Depois que as mudanças forem feitas, selecione Mapeamento de teste novamente para enviar a solicitação novamente.
    8. Selecione Salvar mapeamento .

    Resultado

    Em Observabilidade Da página Detalhes do serviço, painéis e gráficos aparecem para as entidades encontradas no mapeamento.