Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Seu agente investiga com o contexto que você fornece. Se você pulou fontes de dados durante a configuração inicial, ou se uma investigação trouxe menos informações do que você esperava, use este artigo para decidir o que conectar em seguida e o que cada conexão acrescenta. Este artigo lista as fontes disponíveis para o seu agente, enquanto os artigos sobre conectores descrevem o procedimento para cada uma.
Comece pelo menor conjunto útil
Um repositório de código e uma fonte de log são suficientes para respostas fundamentadas sobre seus sistemas. Todas as outras fontes aprofundam o que o agente pode ver, e você pode adicionar fontes em qualquer ordem a qualquer momento, então não há necessidade de terminar a configuração de uma vez só.
Código, logs, recursos do Azure e arquivos de conhecimento se acumulam. Você pode adicionar outro repositório, provedor de telemetria ou escopo sempre que precisar, e pode remover o que não quiser mais. Os incidentes funcionam de forma diferente. Apenas uma plataforma incidente pode estar ativa por vez, e conectar uma nova plataforma desconecta a atual.
O que cada fonte responde
Cada fonte de dados permite que o agente responda a um tipo diferente de pergunta durante a investigação.
| Source | O que permite ao agente responder | O que você precisa para conectá-lo |
|---|---|---|
| Código (recomendado) | Por que uma falha acontece. O agente lê arquivos fonte, rastreia erros em linhas específicas e identifica mudanças recentes. | Acesso a um repositório GitHub, Azure DevOps ou GitLab, além de um método de autenticação que o provedor suporta. |
| Registros (recomendados) | O que aconteceu na produção. O agente consulta sua telemetria e correlaciona as entradas com código e dependências. | Acesso de leitura na fonte de telemetria, concedido à identidade ou credenciais que o conector utiliza. |
| Recursos do Azure | Como é o seu ambiente agora. O agente verifica a configuração dos recursos, a saúde e as métricas. | Uma atribuição de função de Proprietário ou Administrador de Acesso ao Usuário em cada grupo de gerenciamento, assinatura ou grupo de recursos que você adicionar. |
| Incidentes | Quando começar a trabalhar sem ser solicitado. O agente recebe alertas da sua plataforma de incidentes e investiga aqueles que correspondem aos seus planos de resposta. Uma plataforma está ativa por vez. | Azure Monitor conecta sem credenciais, e alertas dos seus grupos de recursos gerenciados chegam ao agente. PagerDuty e ServiceNow precisam das credenciais da API do administrador da sua plataforma de incidentes. |
| Arquivos de conhecimento | Como sua equipe quer que o trabalho seja feito. O agente segue seus runbooks, fluxos de escalonamento e notas de arquitetura. | Um arquivo em formato suportado. Veja Enviar documentos de conhecimento. |
Os provedores de log diferem na forma como autenticam. Azure Data Explorer, Log Analytics Workspace e Application Insights utilizam a identidade gerenciada do agente. Datadog, Dynatrace, Elasticsearch, New Relic, Splunk e Hawkeye usam credenciais de serviço que você fornece. Os provedores que você vê podem variar conforme o locatário e a configuração, então use a caixa de busca se não encontrar o que deseja. Veja Conectar uma fonte de telemetria para ver os campos que cada provedor solicita.
Escolha o que conectar em seguida
Escolha a situação que corresponde ao que está faltando para o seu agente.
- O agente diz que não sabe nada sobre seu aplicativo. Conecte Code primeiro. Isso tem o maior impacto na qualidade da investigação, e o agente começa a explorar o repositório assim que você salva a conexão.
- O agente explica seu código, mas não pode dizer o que aconteceu em produção. Conecte Logs em seguida. Escolha o prestador que sua equipe já consultou durante um incidente.
- Suas perguntas são sobre saúde dos recursos, configuração ou escala. Adicione recursos do Azure, no escopo do grupo de recursos que contém a carga de trabalho que você mais investiga.
- Você quer que o agente trabalhe antes que alguém abra um chat. Conecte a plataforma de incidentes que sua equipe já utiliza e, em seguida, crie um plano de resposta que corresponda a um conjunto restrito de alertas. Como apenas uma plataforma pode estar ativa por vez, escolha aquela que carrega seus alertas de produção. Consulte plataformas de incidentes.
- As respostas são tecnicamente corretas, mas ignore como sua equipe opera. Adicione arquivos de conhecimento para que o agente siga seus procedimentos em vez de uma sequência genérica.
Os recursos e incidentes do Azure são as duas conexões mais propensas a envolver outra pessoa. Ambos mudam o que o agente pode alcançar ou quando ele age, e ambos precisam de acessos que um único engenheiro pode não ter.
Pré-requisitos
| Requirement | Detalhes |
|---|---|
| Um agente | Primeiro, crie um com Criar e configurar. |
| Função no agente | SRE Agent Standard User cobre a adição de repositórios de código e o upload de documentos de conhecimento. SRE Agent Administrator cobre o gerenciamento de conectores e a adição ou remoção de escopos de recursos do Azure. SRE Agent Author aborda a configuração do gerenciamento de incidentes e a elaboração de planos de resposta. Veja Papéis e permissões do usuário. |
| Função do Azure para escopos de recurso | Uma atribuição ativa da função de Proprietário ou da função de Administrador de Acesso do Usuário em cada escopo que você adicionar, diretamente ou por herança. O portal o utiliza para atribuir papéis à identidade gerenciada do agente. |
| Acesso a cada fonte | Acesso ao repositório para código, acesso de leitura na fonte de telemetria para logs e credenciais da plataforma para PagerDuty ou ServiceNow. |
| Alertas ou incidentes a serem recebidos | O Azure Monitor encaminha apenas os alertas gerados pelas suas regras de alerta existentes, então confirme que as regras existem antes de esperar atividade de incidente. PagerDuty e ServiceNow encaminham os incidentes que suas próprias integrações criam. |
Abrir a página de configuração
Na aba Visão Geral do Hub de Operações, a barra de status lista as fontes que você ainda não configurou. Selecione Completar a configuração para abrir a página de configuração, que tem duas abas.
| Tab | Fontes de dados |
|---|---|
| Início rápido | Código, Logs, Recursos do Azure, Incidentes |
| Configuração completa | Tudo no Quickstart, além dos arquivos de Conhecimento |
Cada fonte aparece como um cartão. Um cartão conectado mostra um marcador e um resumo, como o número de repositórios ou provedores de log anexados, junto com quaisquer erros que precisem de atenção.
A página também mostra uma barra de progresso de conexão. A barra acompanha quantos tipos de fonte estão conectados, não quanto essas fontes acrescentam à investigação, e pode contar os tipos que sua página de configuração não oferece. Como resultado, pode não ser concluído mesmo depois de você conectar tudo o que vê. Trate como um indicador aproximado, e não como um alvo. A qualidade da investigação vem da conexão das fontes das quais seu trabalho depende.
Dica
Se o agente disser que não sabe nada sobre seu app e não consegue responder a perguntas sobre ele, conecte o Code antes de qualquer outra coisa.
Conecte uma fonte
Selecione o botão no cartão da fonte desejada e siga o assistente para esse provedor. Para os procedimentos completos, veja:
- Conectar código-fonte
- Conecte uma fonte de telemetria
- Conectores
- Carregar documentos de conhecimento
Confirme se a conexão está funcionando
Verifique o cartão primeiro. Uma conexão bem-sucedida mostra um seletor e uma contagem do que está anexado. Arquivos de conhecimento enviados mostram um status Indexado assim que o agente termina de processá-los. Para revisar suas fontes de conhecimento, veja Conectar conhecimento.
Depois, confirme que o agente pode alcançar a fonte perguntando algo que só essa fonte possa responder.
| Source | Pergunte ao agente |
|---|---|
| Code | "O que faz esse repositório e quais serviços ele contém?" |
| Logs | "Verifique se há algum erro nas últimas 24 horas." |
| Recursos do Azure | "Verifique a saúde dos recursos no grupo <resource-group-name>de recursos." |
| Arquivos de conhecimento | "O que nosso livro de instruções diz sobre lidar com erros HTTP 500?" |
Uma resposta completa mostra um cartão de ferramenta para a fonte consultada pelo agente, juntamente com o resultado retornado. Uma resposta genérica sem cartão de ferramentas, ou uma que reporta acesso perdido, significa que a conexão precisa ser revisada novamente. Para consultas de log que falham com erro de permissão, conceda o acesso de leitura de identidade do conector no recurso alvo e tente novamente.
O que muda quando você adiciona mais contexto
Conectar uma plataforma de incidentes muda a forma como o agente começa a trabalhar. Até lá, o agente responde às pessoas. Depois, também recebe incidentes da sua plataforma e investiga aqueles que correspondem aos seus planos de resposta, no nível de autonomia definido por cada plano. Para configurar esse comportamento, veja Automatizar resposta a incidentes.
Conectar uma fonte não é cobrado separadamente. O Azure SRE Agent mede o processamento que seu agente realiza como uso ativo de fluxo, que abrange chats, incidentes, tarefas agendadas e gatilhos. Contexto mais conectado geralmente significa mais desse processamento, especialmente quando uma plataforma de incidentes inicia investigações sem você. Contexto mais rico também pode encurtar uma investigação, porque o agente gasta menos esforço tentando contornar o que não consegue ver. Veja Preços e cobrança e Avalie o Azure SRE Agent.
Retornar à integração da equipe
Seu tópico de integração de equipe fica na sua lista de Favoritos na barra lateral. Selecione-o para continuar a conversa sempre que tiver algo novo para contar ao corretor, como um serviço que sua equipe adquiriu ou um procedimento que mudou.
Você também pode perguntar ao agente o que configurar em seguida. Ele dá recomendações baseadas no que você conectou e no que ainda está faltando. Veja integração da equipe.