Setup completo para Azure SRE Agent

O teu agente investiga com o contexto que lhe forneces. Se ignorou fontes de dados durante a configuração inicial, ou se uma investigação se revelou menos conclusiva do que esperava, use este artigo para decidir o que ligar a seguir e o que cada ligação acrescenta. Este artigo lista as fontes disponíveis para o seu agente, enquanto os artigos sobre os conectores descrevem o procedimento para cada um deles.

Comece pelo conjunto mais pequeno útil

Um repositório de código e uma fonte de registo são suficientes para respostas fundamentadas sobre os seus sistemas. Todas as outras fontes aprofundam o que o agente consegue ver, e podes adicionar fontes em qualquer ordem a qualquer momento, por isso não há necessidade de terminar a configuração de uma só vez.

O código, registos, recursos do Azure e ficheiros de conhecimento acumulam-se. Pode adicionar outro repositório, fornecedor de telemetria ou âmbito sempre que precisar, e pode remover o que já não quiser. As ocorrências funcionam de forma diferente. Apenas uma plataforma de incidente pode estar ativa de cada vez, e ligar uma nova plataforma desliga a atual.

O que cada fonte responde

Cada fonte de dados permite ao agente responder a um tipo diferente de pergunta durante uma investigação.

Source O que permite ao agente responder O que precisa para ligar
Código (recomendado) Porque é que um fracasso acontece. O agente lê ficheiros fonte, traça erros em linhas específicas e identifica alterações recentes. Acesso a um repositório GitHub, Azure DevOps ou GitLab, além de um método de autenticação que o fornecedor suporta.
Registos (recomendado) O que aconteceu na produção. O agente consulta a sua telemetria e correlaciona 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 teu ambiente neste momento. O agente verifica a configuração dos recursos, a saúde e as métricas. Uma atribuição de funções de Proprietário ou Administrador de Acesso ao Utilizador em cada grupo de gestão, subscrição ou grupo de recursos que adicionar.
Incidentes Quando começar a trabalhar sem ser convidado. O agente recebe alertas da sua plataforma de gestão de incidentes e investiga aqueles que correspondem aos seus planos de resposta. Só uma plataforma pode estar ativa de cada vez. O Azure Monitor liga-se sem credenciais, e os alertas dos seus grupos de recursos geridos chegam ao agente. O PagerDuty e o ServiceNow precisam de credenciais API do administrador da sua plataforma de incidentes.
Ficheiros de conhecimento Como a sua equipa quer que o trabalho seja feito. O agente segue os seus runbooks, os procedimentos de escalonamento e as notas de arquitetura. Um ficheiro num formato suportado. Consulte Carregar documentos de conhecimento.

Os fornecedores de registos diferem na forma como efetuam a autenticação. Azure Data Explorer, Log Analytics Workspace e Application Insights utilizam a identidade gerida do agente. Datadog, Dynatrace, Elasticsearch, New Relic, Splunk e Hawkeye usam as credenciais de serviço que fornece. Os fornecedores que vê podem variar consoante o inquilino e a configuração, por isso use a caixa de pesquisa se não encontrar o que deseja. Consulte Ligar uma origem de telemetria para saber que campos cada fornecedor solicita.

Escolha o que ligar a seguir

Escolha a situação que corresponda ao que o seu agente está a perder.

  • O agente diz que não sabe nada sobre a tua aplicação. Ligue primeiro o Code. Tem o maior impacto na qualidade da investigação, e o agente começa a explorar o repositório assim que guardas a ligação.
  • O agente explica o seu código, mas não consegue dizer o que aconteceu em produção. Ligue Logs de seguida. Escolha o prestador que a sua equipa já consulta durante um incidente.
  • As tuas perguntas são sobre a saúde, configuração ou escala dos recursos. Adicione recursos do Azure no grupo de recursos que aloja a carga de trabalho que investiga com mais frequência.
  • Quer que o agente trabalhe antes de alguém abrir um chat. Ligue a plataforma de incidentes que a sua equipa já utilize e depois crie um plano de resposta que corresponda a um conjunto restrito de alertas. Como só uma plataforma pode estar ativa de cada vez, escolha aquela que transporta os seus alertas de produção. Consulte plataformas de incidentes.
  • As respostas são tecnicamente corretas, mas ignora a forma como a tua equipa opera. Adiciona ficheiros de conhecimento para que o agente siga os teus procedimentos em vez de uma sequência genérica.

Os recursos e incidentes do Azure são as duas ligações mais propensas a envolver outra pessoa. Ambos mudam o que o agente pode alcançar ou quando ele age, e ambos precisam de acesso que um único engenheiro pode não ter.

Pré-requisitos

Requisito Detalhes
Um agente Criar um primeiro com Criar e configurar.
Função no agente SRE Agent Standard User cobre a adição de repositórios de código e o carregamento de documentos de conhecimento. SRE Agent Administrator cobre a gestão de conectores e a adição ou remoção de escopos de recursos do Azure. SRE Agent Author cobre a configuração da gestão de incidentes e a elaboração de planos de resposta. Veja Papéis e permissões dos utilizadores.
Função do Azure para âmbitos de recursos Uma atribuição ativa da função de Proprietário ou Administrador de Acesso ao Utilizador em cada âmbito que adicionar, diretamente ou por herança. O portal utiliza-o para atribuir funções à identidade gerida do agente.
Acesso a cada fonte Acesso ao repositório para código, acesso de leitura na fonte de telemetria para registos e credenciais da plataforma para PagerDuty ou ServiceNow.
Alertas ou incidentes a receber O Azure Monitor encaminha apenas os alertas que as suas regras de alerta existentes geram, por isso confirme que as regras existem antes de esperar atividade de incidente. PagerDuty e ServiceNow encaminham os incidentes que as suas próprias integrações criam.

Abra a página de configuração

No separador Visão Geral do Centro de Operações, a barra de estado lista as fontes que ainda não configuraste. Selecione Concluir a configuração para abrir a página de configuração, que inclui dois separadores.

Tab Fontes de dados
Início rápido Código, Registos, Recursos Azure, Incidentes
Configuração completa Tudo no Quickstart, mais ficheiros de Conhecimento

Cada fonte aparece como uma carta. Um cartão conectado mostra uma marca de verificação e um resumo, como o número de repositórios ou fornecedores de registos associados, bem como quaisquer erros que exijam atenção.

A página também mostra uma barra de progresso da ligação. A barra acompanha quantos tipos de fonte estão ligados, não quanto essas fontes acrescentam a uma investigação, e pode contar os tipos que a tua página de configuração não oferece. Como resultado, pode não chegar a encher completamente, mesmo depois de ligares tudo o que vês. Encare-o como um indicador aproximado em vez de um alvo. A qualidade da investigação resulta da ligação às fontes das quais o seu trabalho depende.

Sugestão

Se o agente disser que não sabe nada sobre a tua aplicação e não pode responder a perguntas, liga o Code antes de qualquer outra coisa.

Ligue uma fonte

Selecione o botão no cartão da origem que pretende e, em seguida, siga o assistente desse fornecedor. Para os procedimentos completos, veja:

Confirmar que a ligação funciona

Verifica primeiro o cartão. Uma conexão bem-sucedida mostra uma marca de verificação e o número de elementos ligados. Os ficheiros de conhecimento carregados mostram um estado Indexado assim que o agente termina de os processar. Para rever as suas fontes de conhecimento, consulte Conectar conhecimento.

Depois confirma que o agente consegue chegar à fonte perguntando-lhe algo que só essa fonte possa responder.

Source Pergunte ao agente
Code "O que faz este repositório e que serviços contém?"
Logs "Verifique se há erros nas últimas 24 horas."
Recursos do Azure "Verifica a saúde dos recursos no grupo <resource-group-name>de recursos."
Ficheiros de conhecimento "O que diz o nosso manual sobre lidar com erros HTTP 500?"

Uma resposta fundamentada mostra um cartão de ferramenta para a fonte que o agente consultou, juntamente com o resultado que devolveu. Uma resposta genérica sem ficha da ferramenta, ou que indica falta de acesso, significa que a ligação tem de ser novamente verificada. Para consultas de registo que falham devido a um erro de permissão, conceda acesso de leitura de identidade ao conector no recurso de destino e tente novamente.

O que muda quando adicionas mais contexto

Ligar uma plataforma de incidentes altera a forma como o agente começa a trabalhar. Até lá, o agente responde às pessoas. Depois, também recebe incidentes provenientes da sua plataforma e investiga aqueles que correspondem aos seus planos de resposta, ao nível de autonomia que cada plano estabelece. Para configurar esse comportamento, veja Automatizar resposta a incidentes.

Ligar uma fonte não é faturado por si só. O Azure SRE Agent mede o processamento que o seu agente realiza como utilização ativa de fluxo, que abrange chats, incidentes, tarefas agendadas e gatilhos. Um contexto mais interligado normalmente significa mais desse tipo de processamento, especialmente quando uma plataforma de gestão de incidentes inicia investigações sem a sua intervenção. Contexto mais rico também pode encurtar uma investigação, porque o agente gasta menos esforço a contornar o que não consegue ver. Consulte Preços e faturação e Avaliar o Agente Azure SRE.

Regresso à integração da equipa

O teu tópico de integração da equipa mantém-se na lista de Favoritos na barra lateral. Selecione-o para continuar a conversa sempre que tiver algo novo para contar ao agente, como um serviço que a sua equipa contratou ou um procedimento que mudou.

Também pode perguntar ao agente o que deve configurar a seguir. Dá recomendações com base no que conectou e no que ainda falta. Ver integração da equipa.

Próximo passo