We are handling an incident in the payments service.
Estamos tratando um incidente no serviço de pagamentos.Aula
Escrever mensagens de incidentes simples
Nível: B1
Objetivo
Escrever mensagens curtas e profissionais de incidente em inglês com a estrutura Impact, Current status, Workaround e Next update, transmitindo a situação sem pânico para stakeholders internos e externos.
Explicação
Em um incidente, a equipe de engenharia precisa atualizar stakeholders — product managers, suporte, clientes, executivos — antes que a ansiedade gere mais ruído. Em B1, espera-se que você mantenha um tom calmo, objetivo e informativo, e que cada mensagem responda a quatro perguntas: o que está acontecendo (impact), o que estamos fazendo agora (current status), o que o usuário pode fazer (workaround) e quando sai a próxima atualização (next update).
A estrutura de quatro blocos
Uma mensagem simples de incidente segue quatro blocos na ordem abaixo. Em comunicações mais longas, cada bloco pode virar um parágrafo; em mensagens de chat, vira uma frase cada.
- Impact — descreva quem é afetado e como, sem minimizar nem dramatizar: `Some users are seeing 500 errors when checking out.`, `A subset of customers in the EU region is experiencing slow page loads.`
- Current status — diga em que fase do fluxo de incidente o time está. As fases-padrão são `investigating`, `identified`, `monitoring` e `resolved`: `We are currently investigating the cause.`, `We have identified the issue as a misconfigured database connection pool.`
- Workaround — ofereça uma ação concreta que o usuário ou o time de suporte pode aplicar agora: `As a workaround, customers can refresh the page after 30 seconds.`, `Internal teams can route traffic to the secondary region.`
- Next update — comprometa-se com um prazo curto e cumpra-o: `We will post the next update in 15 minutes.`, `Next update by 14:30 UTC.`
Tom profissional em incidente
Comunique sem pânico. Em inglês técnico de engenharia, isso significa preferir voz ativa, evitar hipérboles, ancorar afirmações em evidência e não especular sobre a causa antes de confirmar:
- Evite: `Everything is broken!`, `This is a disaster.`, `We have no idea what's happening.`
- Prefira: `We are seeing elevated error rates.`, `The team is investigating.`, `We will share an update as soon as we have more information.`
Erros comuns incluem superestimar a confiança (`It's fixed.` antes de monitorar) e subestimar o impacto (`Only a few users.` sem números). Em incidente, descrição > adjetivo.
Frases de abertura prontas
Tenha à mão algumas frases-âncora que podem ser combinadas em quase qualquer incidente:
- `We are currently investigating an issue affecting [service/region/users].`
- `We have identified the cause and are working on a fix.`
- `A fix has been deployed. We are monitoring the results.`
- `The issue has been resolved. A post-mortem will follow.`
- `As a workaround, [action]. We will update in [timeframe].`
A frase `We will update in 15 minutes.` é a promessa mínima para stakeholders em incidentes ativos. Manter essa cadência (15/30 min) preserva confiança mesmo quando ainda não há solução.
Exemplos
| Inglês | Tradução | Observação |
|---|---|---|
| We are currently investigating an issue affecting checkout in the EU region. | Estamos investigando um problema que afeta o checkout na região da Europa. | Abertura padrão: investigating + escopo do impacto. |
| Some users are seeing 500 errors when placing orders. | Alguns usuários estão vendo erros 500 ao fazer pedidos. | Descreve o impacto com verbo neutro (seeing) e detalhe técnico (500 errors). |
| We have identified the cause as a misconfigured connection pool. | Identificamos a causa: um pool de conexões mal configurado. | Identified marca transição de investigating para identified; 'misconfigured' é claro e específico. |
| As a workaround, customers can refresh the page after 30 seconds. | Como solução temporária, os clientes podem atualizar a página depois de 30 segundos. | Workaround sempre vem com ação concreta para o usuário. |
| A fix has been deployed. We are monitoring the results. | Uma correção foi implantada. Estamos monitorando os resultados. | Monitoring sinaliza que ainda não é resolved; evita prometer antes da confirmação. |
| Next update in 15 minutes. | Próxima atualização em 15 minutos. | Promessa curta de cadência; estabiliza a ansiedade dos stakeholders. |
| The issue has been resolved. A post-mortem will follow within 48 hours. | O problema foi resolvido. Um post-mortem virá em até 48 horas. | Resolved fecha o incidente e abre o ciclo de aprendizagem. |
Erros comuns
- Anunciar 'It's fixed' antes de monitorar: prefira 'A fix has been deployed. We are monitoring the results.'
- Usar pânico ou hipérbole ('Everything is broken!', 'This is a disaster'): substitua por 'elevated error rates' ou 'a subset of users'.
- Esquecer o workaround: stakeholders precisam de algo para fazer enquanto o fix não chega.
- Dizer 'We have no idea' durante investigating: prefira 'We are still investigating' e comprometa uma próxima atualização.
- Prometer uma causa sem confirmar: 'It's a database issue' sem evidência confunde stakeholders; use 'We have identified the cause as...' depois da confirmação.
- Esquecer o 'next update' ou prometer 'soon': cadência fixa (15/30 min) gera mais confiança do que prazos vagos.
- Misturar 'affected' e 'effected': 'affected' é o adjetivo correto para usuários/serviços impactados; 'effected' é verbo e significa 'executar'.
Prática guiada
Reescreva cada versão exagerada em uma mensagem profissional de incidente:
- Exagerada: `Everything is on fire! Nobody can use the app!`
Profissional: `We are currently investigating an issue affecting login. Some users are unable to sign in. We will update in 15 minutes.`
- Exagerada: `It's totally fixed.`
Profissional: `A fix has been deployed. We are monitoring the results and will confirm resolution shortly.`
- Faltando workaround: `We are working on it.`
Completa: `We are investigating elevated error rates. As a workaround, customers can retry the request after one minute. Next update in 15 minutes.`
Observe como a versão profissional descreve o impacto com números ou escopo (`some users`, `elevated error rates`) e sempre fecha com o próximo passo.
Resumo
Uma mensagem simples de incidente segue quatro blocos: Impact (quem é afetado e como), Current status (investigating, identified, monitoring ou resolved), Workaround (ação temporária) e Next update (prazo curto e firme). O tom é calmo, objetivo e ancorado em evidência: descreva o que está acontecendo, evite pânico e hipérbole, não antecipe a causa antes de confirmar e sempre feche a mensagem com a próxima atualização.
Vocabulário
Palavras principais
The outage started at 09:12 UTC.
A queda começou às 09:12 UTC.The impact is limited to the EU region.
O impacto está limitado à região da Europa.Affected users see a 500 error on the order page.
Usuários afetados veem um erro 500 na página de pedidos.We are seeing elevated error rates in production.
Estamos vendo taxas de erro elevadas em produção.We are currently investigating the cause.
Estamos investigando a causa no momento.We have identified the root cause as a memory leak.
'Identificamos a causa raiz: um vazamento de memória.'A fix has been deployed. We are monitoring the results.
Uma correção foi implantada. Estamos monitorando os resultados.The issue has been resolved.
O problema foi resolvido.As a workaround, please retry the request after one minute.
Como solução temporária, tente novamente o pedido depois de um minuto.The fix is being deployed to production.
A correção está sendo implantada em produção.We need to keep stakeholders informed during the incident.
Precisamos manter os stakeholders informados durante o incidente.A post-mortem will be shared within 48 hours.
Um post-mortem será compartilhado em até 48 horas.We confirmed the root cause of the outage.
Confirmamos a causa raiz da queda.Next update in 15 minutes.
Próxima atualização em 15 minutos.As a workaround, customers can use the mobile app.
Como solução temporária, os clientes podem usar o app mobile.We are currently investigating elevated latency in the API.
Estamos investigando latência elevada na API.We have identified the issue as a database connection timeout.
'Identificamos o problema: um timeout de conexão com o banco.'História
História: Escrever mensagens de incidentes simples
Nível: B1
História em inglês
The first alert
On Tuesday morning, Sam was on call when his phone buzzed with a PagerDuty alert at 09:12 UTC. The error rate in the payments service had climbed to 8% — well above the usual 0.3%. Some users were seeing timeouts when they tried to complete a purchase, and the support queue was filling up fast. Sam joined the incident channel, said hello, and started drafting the first stakeholder update. He wrote, "We are currently investigating an issue affecting checkout. Some users are seeing timeouts when paying. We will update in 15 minutes."
From investigating to identified
Ten minutes later, Sam and the team had narrowed the issue down to a single database connection pool. The pool was saturated, so new transactions had to wait and eventually failed. Sam sent the second update: "We have identified the cause as a saturated connection pool in the payments service. The team is working on a fix." Maya from support asked for a workaround, because customers were still calling in. Sam replied, "As a workaround, customers can use the legacy checkout at checkout-old.example.com. It bypasses the new pool entirely." He closed the message with, "Next update in 15 minutes."
Deploying the fix and monitoring
At 09:45 UTC, the team deployed a fix that raised the connection pool size and added better error handling. Sam sent the third update: "A fix has been deployed. We are monitoring the results. Next update in 15 minutes." The error rate started dropping — 8%, then 4%, then 1% — and the support queue began to empty. Forty minutes after the alert, Sam declared the incident resolved and sent the final update. He wrote, "The issue has been resolved. A post-mortem will be shared within 48 hours. Thank you for your patience." Later, in the retrospective, the team agreed that the calm cadence of updates had kept stakeholders calm too.
Tradução linha por linha
| Inglês | Tradução |
|---|---|
| On Tuesday morning, Sam was on call when his phone buzzed with a PagerDuty alert at 09:12 UTC. | Na manhã de terça-feira, Sam estava de plantão quando o celular vibrou com um alerta do PagerDuty às 09:12 UTC. |
| The error rate in the payments service had climbed to 8% — well above the usual 0.3%. | A taxa de erro no serviço de pagamentos tinha subido para 8% — bem acima do 0,3% habitual. |
| Some users were seeing timeouts when they tried to complete a purchase, and the support queue was filling up fast. | Alguns usuários estavam vendo timeouts ao tentar finalizar uma compra, e a fila de suporte estava enchendo rápido. |
| Sam joined the incident channel, said hello, and started drafting the first stakeholder update. | Sam entrou no canal de incidente, cumprimentou a equipe e começou a rascunhar a primeira atualização para os stakeholders. |
| He wrote, "We are currently investigating an issue affecting checkout. Some users are seeing timeouts when paying. We will update in 15 minutes." | Ele escreveu: "Estamos investigando um problema que afeta o checkout. Alguns usuários estão vendo timeouts ao pagar. Próxima atualização em 15 minutos." |
| Ten minutes later, Sam and the team had narrowed the issue down to a single database connection pool. | Dez minutos depois, Sam e a equipe já tinham isolado o problema em um único pool de conexões do banco. |
| The pool was saturated, so new transactions had to wait and eventually failed. | O pool estava saturado, então as novas transações tinham que esperar e, no fim, falhavam. |
| Sam sent the second update: "We have identified the cause as a saturated connection pool in the payments service. The team is working on a fix." | Sam enviou a segunda atualização: "Identificamos a causa: um pool de conexões saturado no serviço de pagamentos. A equipe está trabalhando em uma correção." |
| Maya from support asked for a workaround, because customers were still calling in. | Maya, do suporte, pediu um workaround, porque os clientes ainda estavam ligando. |
| Sam replied, "As a workaround, customers can use the legacy checkout at checkout-old.example.com. It bypasses the new pool entirely." | Sam respondeu: "Como solução temporária, os clientes podem usar o checkout legado em checkout-old.example.com. Ele ignora o pool novo por completo." |
| He closed the message with, "Next update in 15 minutes." | Ele fechou a mensagem com: "Próxima atualização em 15 minutos." |
| At 09:45 UTC, the team deployed a fix that raised the connection pool size and added better error handling. | Às 09:45 UTC, a equipe implantou uma correção que aumentou o tamanho do pool de conexões e adicionou um melhor tratamento de erros. |
| Sam sent the third update: "A fix has been deployed. We are monitoring the results. Next update in 15 minutes." | Sam enviou a terceira atualização: "Uma correção foi implantada. Estamos monitorando os resultados. Próxima atualização em 15 minutos." |
| The error rate started dropping — 8%, then 4%, then 1% — and the support queue began to empty. | A taxa de erro começou a cair — 8%, depois 4%, depois 1% — e a fila de suporte começou a esvaziar. |
| Forty minutes after the alert, Sam declared the incident resolved and sent the final update. | Quarenta minutos depois do alerta, Sam declarou o incidente como resolvido e enviou a atualização final. |
| He wrote, "The issue has been resolved. A post-mortem will be shared within 48 hours. Thank you for your patience." | Ele escreveu: "O problema foi resolvido. Um post-mortem será compartilhado em até 48 horas. Obrigado pela paciência." |
| Later, in the retrospective, the team agreed that the calm cadence of updates had kept stakeholders calm too. | Mais tarde, na retrospectiva, a equipe concordou que a cadência calma de atualizações também manteve os stakeholders calmos. |
Notas de vocabulário
- PagerDuty alert = alerta de plantão; ferramenta comum para on-call em engenharia
- error rate = taxa de erro; métrica padrão para medir o impacto de um incidente
- We are currently investigating an issue affecting checkout. = abertura padrão: investigating + escopo do impacto
- Some users are seeing timeouts when paying. = descrição do impacto com escopo e sintoma técnico (timeouts)
- We have identified the cause as a saturated connection pool. = transição para a fase identified; 'as' introduz a causa confirmada
- As a workaround, customers can use the legacy checkout. = workaround sempre vem com ação concreta para o usuário
- Next update in 15 minutes. = promessa firme de cadência; estabiliza stakeholders durante o incidente
- A fix has been deployed. We are monitoring the results. = has been deployed + monitoring evita prometer resolução antes da confirmação
- The issue has been resolved. = has been resolved encerra o incidente em voz passiva
- post-mortem = revisão técnica após o incidente; prazo típico: within 48 hours
Perguntas de compreensão
- When did the PagerDuty alert fire, and what was Sam's role at that moment?
- What was unusual about the error rate when the alert fired?
- What did Sam write in the first stakeholder update?
- What had the team identified ten minutes later?
- Why was Maya asking for a workaround?
- What workaround did Sam suggest?
- What did the team deploy at 09:45 UTC?
- What evidence showed the fix was working?
- How long after the alert did Sam declare the incident resolved?
- What did the team agree on in the retrospective about the updates?
Prática com a história
- Reescreva a abertura com tom profissional: 'The whole checkout is broken, help!'
- Reescreva o anúncio de correção: 'It's totally fixed now.'
- Ofereça um workaround: o time vai levar 20 minutos para aplicar a correção.
- Feche a mensagem de incidente com cadência firme.
Prática
Exercícios e teste
A próxima melhoria é transformar esses arquivos em perguntas com resposta no navegador. Por enquanto, esta página já organiza o estudo e permite seguir a aula inteira sem abrir os arquivos manualmente.