View a markdown version of this page

Conectando PagerDuty - AWS DevOps Agente
PagerDuty requisitosRegistrando PagerDutyAdicionando PagerDuty a um espaço do agenteGerenciando PagerDuty conexõesSuporte para webhook

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Conectando PagerDuty

PagerDuty a integração permite que o AWS DevOps agente acesse e atualize dados de incidentes, agendas de plantão e informações de serviço de sua PagerDuty conta durante investigações de incidentes e respostas automatizadas. Essa integração usa o OAuth 2.0 para autenticação segura.

Importante

AWS DevOps O agente só oferece suporte ao PagerDuty OAuth 2.0 mais recente (Scoped OAuth). O PagerDuty OAuth legado com uri de redirecionamento não é suportado.

PagerDuty requisitos

Antes de conectar PagerDuty, verifique se você tem:

  • Uma PagerDuty conta com seu ID de cliente OAuth e segredo do cliente

  • O subdomínio PagerDuty da sua conta (por exemplo, se sua PagerDuty URL forhttps://your-company.pagerduty.com, o subdomínio será) your-company

Registrando PagerDuty

PagerDuty é registrado no nível da AWS conta e compartilhado entre todos os espaços do agente nessa conta. Cada registro corresponde a uma PagerDuty conta, identificada por sua região e subdomínio. Para registrar PagerDuty contas adicionais, repita esse processo para cada uma.

Etapa 1: configurar o acesso em PagerDuty

  1. Faça login no AWS Management Console

  2. Navegue até o console do AWS DevOps agente

  3. Vá para a página Provedores de Capacidades (acessível pela navegação lateral)

  4. Encontre PagerDuty na seção Provedores disponíveis em Comunicação e escolha Registrar

  5. Siga a configuração guiada na PagerDuty página Configurar acesso em:

Verifique sua região de serviço e subdomínio:

  • Escopo da conta — Selecione sua PagerDuty região (EUA ou UE) e insira seu PagerDuty subdomínio. Por exemplo, se sua PagerDuty URL forhttps://your-company.pagerduty.com, insirayour-company.

Crie um novo aplicativo em PagerDuty:

  • Em uma guia separada do navegador, faça login PagerDuty e navegue até Integrações > Registro de aplicativos

  • Crie um novo aplicativo usando o OAuth 2.0 Scoped OAuth

  • Em Permissões, conceda os seguintes escopos mínimos exigidos:incidents.read,incidents.write, services.readwebhook_subscriptions.read, e webhook_subscriptions.write

  • Habilite a integração de eventos para permitir a comunicação bidirecional entre o agente e AWS DevOps PagerDuty

Configure as credenciais do OAuth:

  • Escopo da permissão — Os escopos mínimos exigidos são:incidents.read,incidents.write,services.read, webhook_subscriptions.read webhook_subscriptions.write

  • Nome do cliente — Insira um nome descritivo para seu cliente OAuth

  • ID do cliente — Insira o ID do cliente OAuth do registro do seu aplicativo PagerDuty

  • Segredo do cliente — Insira o segredo do cliente OAuth no registro do seu aplicativo PagerDuty

Etapa 2: revisar e enviar o PagerDuty registro

  1. Revise todos os detalhes da PagerDuty configuração

  2. Escolha Enviar para concluir o registro

  3. Após o registro bem-sucedido, PagerDuty aparece na seção Registrado atualmente da página Provedores de Capacidades

Adicionando PagerDuty a um espaço do agente

Depois de se registrar PagerDuty no nível da conta, você pode conectá-la a espaços de agentes individuais:

  1. No console do AWS DevOps Agente, selecione seu Espaço do Agente

  2. Vá para a guia Capacidades

  3. Na seção Comunicações, escolha Adicionar

  4. Escolha o PagerDuty registro que você deseja conectar a este Espaço do Agente.

  5. Escolha Salvar

Um único Agent Space pode usar mais de um PagerDuty registro. Para conectar outro registro, repita essas etapas.

Gerenciando PagerDuty conexões

  • Atualização de credenciais — Se suas credenciais do OAuth precisarem ser atualizadas, cancele o registro na página Provedores PagerDuty de Capacidade e registre-se novamente com as novas credenciais.

  • Visualizando conexões — No console do AWS DevOps Agente, selecione seu Espaço do Agente e vá até a guia Capacidades para ver as integrações de comunicação conectadas.

  • Removendo PagerDuty — Para se desconectar PagerDuty de um Espaço do Agente, selecione-o na seção Comunicações e escolha Remover. Para remover completamente o registro, remova-o primeiro de todos os Espaços do Agente e depois cancele o registro na página Provedores de Capacidades.

Suporte para webhook

AWS DevOps O agente só oferece suporte a PagerDuty webhooks V3. As versões anteriores do webhook não são suportadas.

Para obter mais informações sobre assinaturas de webhooks PagerDuty V3, consulte Visão geral dos webhooks na documentação do desenvolvedor. PagerDuty