Conecte uma fonte de telemetria

Conecte uma fonte de telemetria para fundamentar as respostas do seu agente nos seus próprios sinais, não em 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 aborda conectores na categoria Telemetria . Azure Data Explorer usa o caminho Azure MCP Kusto. Conectores de telemetria de terceiros também aparecem na aba de Telemetria , mesmo quando usam MCP nos bastidores. A configuração usa o mesmo assistente de todo conector gerenciado, então este artigo foca em detalhes de telemetria: como as fontes se autenticam, quais operações ativar e como validar com uma consulta.

Importante

Conectores gerenciados estão em prévia. Disponibilidade de conectores, campos e operações podem mudar.

Pré-requisitos

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

Se você nunca configurou um conector antes, comece com Configure um conector gerenciado para o guia completo do assistente. Este artigo destaca apenas as diferenças na fonte da telemetria.

Conectores de telemetria

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

Conectores de telemetria de terceiros incluem URL padrão, autenticação e dicas de cabeçalho para ajudar a configurar a conexão.

Você também pode adicionar outra fonte de telemetria por meio de um conector fornecido pelo usuário. Use essa opção quando sua equipe tiver uma ferramenta personalizada ou uma fonte que não esteja listada no conector picker.

Passo 1: Adicionar o conector

1. Vá para sre.azure.com e selecione seu agente.

2. Na barra lateral esquerda, expanda Construtor e então selecione Conectores.

3. Selecione Adicionar conector.

4. Selecione a aba de Telemetria e então escolha sua fonte de telemetria. Para Azure Data Explorer, selecione Azure Data Explorer, que utiliza o caminho Azure MCP Kusto.

Passo 2: Autenticar

Fontes de telemetria do Azure

Para conectores de telemetria Azure:

1. Preencha os campos mostrados pelo conector.

   • Para o Azure Data Explorer, nomeie o conector, selecione a identidade gerenciada que o agente usa para consultar o Kusto e então 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 workspace ou insira manualmente o ID do recurso ARM do workspace.
   • Para Insights de Aplicação, selecione um recurso de Insights de Aplicação no seletor de recursos ou insira manualmente o ID de recurso ARM de recursos.

2. Selecione uma identidade gerenciada quando o conector solicitar uma.

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

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

Fontes de telemetria de terceiros

Para conectores de telemetria de terceiros e conectores fornecidos pelo usuário:

1. Revise a URL, autenticação e campos de cabeçalho mostrados pelo conector.

2. Insira os valores necessários para o seu serviço de telemetria.

3. Selecione Conectar.

Conectores de terceiros incluem padrões e dicas. Seu serviço pode ainda exigir uma URL de locatário, token de API ou valor de cabeçalho personalizado do administrador de observabilidade.

Passo 3: Configurar ferramentas de consulta

Na etapa de Configurar ferramentas , ative as operações que leem telemetria. Operações de consulta são o núcleo de um conector de telemetria, então selecione as operações run-query ou search. Deixe as operações administrativas desativadas, a menos que você precise delas.

Defina cada operação de leitura para Permitir para que o agente possa responder perguntas sem pausar. Se você ativar alguma operação que altere dados, defina para Perguntar.

Para Azure Data Explorer via Azure MCP, o assistente inclui uma etapa de grupo de cluster e uma etapa de revisão com teste de conexão. Configure os grupos do cluster, teste a conectividade e salve o conector. O conjunto de ferramentas Kusto é tratado pelo caminho Kusto do Azure MCP.

Dica

Mantenha o conjunto habilitado pequeno. Um conector de telemetria geralmente precisa apenas de suas operações de consulta. Menos ferramentas significa que o corretor escolhe a certa com mais confiança e permanece dentro do orçamento de 80 ferramentas.

Passo 4: Valide com uma pergunta

1. Abra um chat com seu agente.

2. Faça uma pergunta que exija sua telemetria. Por exemplo:

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

3. Assista à resposta. Um cartão de ferramenta mostra o agente selecionando a ferramenta de consulta do conector e executando a consulta, seguida de uma resposta baseada na sua telemetria.

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

Troubleshooting

Problema	Cause	Corrigir
Consulta retorna "Não autorizado" ou "Proibido"	A identidade de conexão não possui acesso de leitura	Conceda ao leitor de identidade acesso ao recurso alvo e então tente novamente.
Consulta retorna "não encontrado"	Nome errado de workspace, cluster, banco de dados ou tabela	Confirme o nome exato no serviço. Os nomes diferenciam maiúsculas de minúsculas.
Conector de terceiros não consegue se conectar	URL, token ou valor de cabeçalho está errado	Confirme os valores com seu administrador de observabilidade e atualize o conector.
A resposta é genérica e nenhum cartão de ferramentas aparece	A pergunta não exigia sua telemetria	Reformule para que a pergunta precise da sua telemetria, como "conte as solicitações falhadas no serviço X para o último dia."
Conector salvo, mas nenhuma telemetria retornada	Resultado vazio ou filtrado	Amplie o intervalo de tempo da sua pergunta, ou confirme que a fonte tem telemetria recente.

Conteúdo relacionado

• Conecte um serviço de código-fonte
• Conecte um serviço de notificação
• Configure um conector gerenciado