Ligue uma fonte de telemetria

Liga uma fonte de telemetria para fundamentar as respostas do teu agente nos teus próprios sinais, não no conhecimento geral. Depois de configurar um conector de telemetria, faça uma pergunta de investigação em linguagem simples. O agente executa a consulta e responde com números reais.

Este tutorial cobre conectores na categoria de Telemetria . Azure Data Explorer utiliza o caminho Azure MCP Kusto. Conectores de telemetria de terceiros também aparecem no separador de Telemetria , mesmo quando usam MCP nos bastidores. A configuração utiliza o mesmo assistente de todos os conectores geridos, por isso este artigo foca-se nos detalhes da telemetria: como as fontes se autenticam, que operações ativar e como validar com uma consulta.

Importante

Os conectores geridos estão em pré-visualização. A disponibilidade dos conectores, os campos e as operações podem mudar.

Pré-requisitos

  • Um Agente SRE a correr e acesso a sre.azure.com.
  • Permissão para configurar conectores no agente.
  • Leia o acesso à fonte de telemetria que está a ligar. Para uma fonte Azure, a identidade que autoriza a ligação precisa pelo menos de acesso de leitura ao recurso alvo.

Se nunca configuraste um conector antes, começa com Configurar um conector gerido para o guia completo do assistente. Este artigo destaca apenas as diferenças na fonte de telemetria.

Conectores de telemetria

Conector Serviço Authentication Uso típico
Azure Data Explorer (via Azure MCP) Azure Data Explorer (Kusto) Identidade gerenciada Executar consultas KQL contra clusters ADX
Espaço de Trabalho do Log Analytics Análise de Registos Identidade gerenciada Consultar logs de espaço de trabalho em modo apenas de leitura
Application Insights Application Insights Identidade gerenciada Consulta à telemetria da aplicação em modo apenas de leitura
Datadog Datadog Credenciais de serviço apresentadas pelo conector Métricas de consulta, registos e monitores
Elasticsearch Elasticsearch Credenciais de serviço apresentadas pelo conector Registos de pesquisa e telemetria indexada
Dynatrace Dynatrace Credenciais de serviço apresentadas pelo conector Dados de observabilidade e traços de consulta
New Relic New Relic Credenciais de serviço apresentadas pelo conector Telemetria e incidentes de consulta
Splunk Splunk Credenciais de serviço apresentadas pelo conector Pesquise registos e eventos do Splunk
Hawkeye (NeuBird) Hawkeye por NeuBird Credenciais de serviço apresentadas pelo conector Consultar dados de observabilidade alimentados por IA

Os conectores de telemetria de terceiros incluem URL predefinido, autenticação e dicas de cabeçalho para ajudar a configurar a ligação.

Também pode adicionar outra fonte de telemetria através de um conector fornecido pelo utilizador. Use esta opção quando a sua equipa tiver uma ferramenta personalizada ou uma fonte que não esteja listada no conector picker.

Passo 1: Adicionar o conector

  1. Vai a sre.azure.com e escolhe o teu agente.

  2. Na barra lateral esquerda, expande Builder e depois seleciona Connectors.

  3. Selecionar Adicionar conector.

  4. Selecione o separador de Telemetria e depois escolha a sua fonte de telemetria. Para Azure Data Explorer, selecione Azure Data Explorer, que usa o caminho Azure MCP Kusto.

Passo 2: Autenticar

Para conectores de telemetria Azure:

  1. Preencha os campos mostrados pelo conector.

    • Para Azure Data Explorer, nomeie o conector, selecione a identidade gerida que o agente usa para consultar o Kusto e depois adicione um ou mais grupos de cluster com URLs de cluster.
    • Para o Log Analytics Workspace, selecione um espaço de trabalho no seletor de espaços de trabalho ou introduza manualmente o ID do recurso ARM do espaço de trabalho.
    • Para Application Insights, selecione um recurso Application Insights no seletor de recursos, ou introduza manualmente o ID de recurso ARM.

  2. Selecione uma identidade gerida quando o conector a solicitar.

  3. Continue para a etapa de revisão, cluster ou seleção de ferramentas mostrada pelo assistente.

A identidade gerida deve ter acesso de leitura ao recurso alvo. Se as consultas falharem posteriormente devido a um erro de permissão, conceda acesso de leitura a essa identidade e tente novamente a consulta.

Passo 3: Configurar ferramentas de consulta

No passo Configurar ferramentas , ativa as operações que leem telemetria. As operações de consulta são o núcleo de um conector de telemetria, por isso selecione as operações run-query ou search. Deixe as operações administrativas desativadas, a menos que precise delas.

Defina cada operação de leitura para Permitir para que o agente possa responder a perguntas sem pausar. Se ativares alguma operação que altere dados, define-a para Perguntar.

Para Azure Data Explorer através do Azure MCP, o assistente inclui uma etapa de grupo de cluster e uma etapa de revisão com testes de ligação. Configure os grupos do cluster, teste a conectividade e guarde o conector. O conjunto de ferramentas Kusto é tratado pelo caminho Kusto Azure MCP.

Gorjeta

Mantenha o conjunto ativado pequeno. Um conector de telemetria normalmente necessita apenas das suas operações de consulta. Menos ferramentas significa que o agente escolhe a certa de forma mais fiável e mantém-se dentro do orçamento de 80 ferramentas.

Passo 4: Validar com uma pergunta

  1. Abre um chat com o teu agente.

  2. Faz uma pergunta que exija a tua telemetria. Por exemplo:

    How many errors were logged in the last hour, grouped by service?

  3. Observa a resposta. Um cartão de ferramenta mostra ao agente selecionar a ferramenta de consulta do conector e executar a consulta, seguida de uma resposta baseada na sua telemetria.

Quando vês uma contagem real da tua própria fonte em vez de uma explicação geral, o conector funciona de ponta a ponta.

Troubleshooting

Problema Cause Corrigir
A consulta devolve "Não autorizado" ou "Proibido" A identidade da ligação não tem acesso de leitura Concede à leitura de identidade acesso ao recurso alvo e depois tenta novamente.
A consulta devolve "não encontrado" Nome errado de espaço de trabalho, cluster, base de dados ou tabela Confirma o nome exato no serviço. Os nomes são sensíveis às maiúsculas e minúsculas.
O conector de terceiros não consegue ligar-se URL, token ou valor de cabeçalho está errado Confirme os valores com o administrador de observabilidade e atualize o conector.
A resposta é genérica e não aparece nenhum cartão de ferramentas A pergunta não exigia a tua telemetria Reformule para que a pergunta precise da sua telemetria, como "contar os pedidos falhados no serviço X para o último dia."
Conector salvo mas sem telemetria devolveda Resultado vazio ou filtrado Alarga o intervalo temporal da tua pergunta, ou confirma que a fonte tem telemetria recente.

Conteúdo relacionado

  • Last updated on