Inglês técnico para TI (tecnologia da informação): como explicar um incidente em produção

Por Alex Barros, intérprete simultâneo há 25 anos · atualizado em

Resumo: Explicar um incidente em inglês segue uma linha do tempo de cinco fases: detecção, impacto, mitigação, causa raiz e ações de acompanhamento. Este guia dá as frases de cada fase, os tempos verbais que combinam com elas, o vocabulário que separa mitigar de resolver, a estrutura de um post-mortem sem culpados e o tom certo para falar com engenheiros e com executivos. A regra central é dizer o que se sabe, o que não se sabe e qual é o próximo passo, sem dramatizar, sem minimizar e sem prometer o que ainda não foi verificado.

Escrevo "TI (tecnologia da informação)" por extenso na primeira menção porque "ti", em minúsculas, também se lê como "você". Daqui em diante uso só a sigla.

Interpreto há 25 anos, a maior parte do tempo em reuniões de finanças. Nelas, de vez em quando, entra um incidente: um sistema de pagamentos que parou, uma plataforma de negociação com lentidão, um portal de clientes fora do ar. Quando isso acontece, a reunião muda de natureza. Quem fala deixa de apresentar e passa a explicar um problema, ao vivo, para pessoas que precisam decidir rápido. A diferença entre uma explicação boa e uma ruim, nesse contexto, raramente é técnica. É de organização e de tom.

O profissional de TI brasileiro costuma ler inglês técnico sem dificuldade: logs, documentação, tickets, mensagens de erro. O que trava é falar, sob pressão, para uma plateia que não tem paciência com rodeios. A pessoa sabe o que aconteceu, mas não tem a frase pronta, e a frase que sai é uma tradução literal do português que soa estranha ou, pior, imprecisa.

Este guia é um roteiro para esse momento. Não substitui o runbook da sua empresa nem o processo formal de resposta a incidentes. Dá a linguagem: as frases de cada fase, as armadilhas e a estrutura do documento que vem depois. Para o vocabulário geral da área, veja o guia de termos de TI em inglês.

Vocabulário mínimo de um incidente

Antes das fases, os termos. Muitos têm tradução óbvia em português, mas o uso em inglês tem nuances que importam quando se fala com precisão.

Termo Significado Frase de exemplo
incident evento que afeta ou ameaça afetar o serviço We declared an incident at 14:05.
outage indisponibilidade total ou parcial The outage lasted about forty minutes.
degradation piora de desempenho sem parada total Search had degraded performance for an hour.
impact efeito sobre usuários ou negócio The impact was limited to one region.
severity (SEV) gravidade do incidente We classified it as a SEV 1.
on call de plantão I'm on call this week.
incident commander quem coordena a resposta The incident commander assigns the tasks.
alert alerta automático An alert fired at 14:05.
error rate taxa de erro The error rate dropped back to normal.
latency tempo de resposta Latency increased for all requests.
mitigation ação que reduz o impacto sem eliminar a causa Mitigation took twenty minutes.
workaround solução de contorno There is a workaround for affected customers.
rollback reversão para a versão anterior The rollback restored service.
failover troca para o sistema reserva The failover to the secondary region worked.
root cause causa raiz The root cause was an expired certificate.
trigger o que disparou o problema The trigger was a configuration change.
contributing factor fator que agravou ou permitiu o problema A missing alert was a contributing factor.
status page página pública de status We updated the status page at 14:15.
stakeholder parte interessada We kept stakeholders informed every thirty minutes.
ETA previsão de conclusão We don't have an ETA yet.
post-mortem análise feita depois do incidente The post-mortem is scheduled for Thursday.
action item ação de acompanhamento com responsável Each action item has an owner.

Dois pares pedem atenção. O primeiro é incident e outage. Um incidente pode ser uma ameaça sem parada nenhuma, como uma falha que ainda não afetou usuários. Uma outage é a indisponibilidade em si. Nem todo incidente é uma outage, e dizer "outage" quando só havia lentidão exagera o problema.

O segundo é mitigation e resolution. Mitigar é reduzir o impacto: voltar a versão, desligar uma funcionalidade, trocar para o sistema reserva. Resolver é eliminar a causa. Muitas vezes o incidente é mitigado em vinte minutos e a causa só é resolvida dias depois. Quem usa "fixed" ou "resolved" quando só mitigou cria uma expectativa que o próximo alerta desmente.

A linha do tempo em cinco fases

Todo incidente, por mais complexo, pode ser contado na mesma ordem. Isso vale para a explicação oral numa chamada, para a atualização escrita na página de status e para o post-mortem. Se você tem a ordem na cabeça, as frases vêm mais fácil.

Fase Pergunta que responde
Detecção Como e quando soubemos?
Impacto Quem foi afetado e como?
Mitigação O que fizemos para reduzir o problema?
Causa raiz Por que aconteceu?
Ações O que vamos fazer para reduzir a chance de repetir?

Durante o incidente, a causa raiz muitas vezes ainda é desconhecida, e a explicação para em mitigação. Isso é normal e deve ser dito. Uma atualização honesta no meio do incidente diz: "We have mitigated the impact. We are still investigating the root cause." Isso é melhor do que um palpite apresentado como fato.

Fase 1: detecção

Aqui você conta como o problema apareceu. Duas coisas importam: o horário e a fonte. Sempre diga o fuso horário, mesmo quando todos estão no mesmo. Em times distribuídos, "at two o'clock" sem fuso é um convite a erro. Em contexto técnico, é comum usar UTC e hora de 24 horas, e ler "14:05" como "fourteen oh five".

Frase Uso
An alert fired at 14:05 UTC for elevated error rates on the payments API. Detecção por monitoramento
We became aware of the issue at 14:07, when customers started reporting failed payments. Detecção por relato de cliente
Our monitoring detected a spike in latency. Detecção automática
A customer reported that the app was not loading. Relato individual
We detected the issue before any customer reported it. Quando a detecção foi proativa
We are investigating reports of failed logins. Atualização inicial
We don't know the cause yet. Dizer o que não se sabe

O verbo "to fire" para alertas é padrão: "the alert fired". Também se ouve "the alert went off" e "the alert triggered", mas "fired" é o mais usado em times de plataforma.

Sobre tempos verbais: o que já aconteceu vai no passado simples, com horário. "The alert fired at 14:05." Quando a investigação está em curso, use o presente contínuo: "We are investigating." O resultado de uma ação que ainda vale agora usa o presente perfeito: "We have identified the cause." Misturar esses três tempos é o erro mais comum de brasileiros em atualizações de incidente. Dizer "We identify the cause" ou "We did identified" soa errado, e numa atualização em que cada frase importa isso desvia a atenção.

Fase 2: impacto

O impacto é a parte que o executivo mais quer ouvir, e a que o engenheiro mais tende a pular. Fale em termos de quem foi afetado e do que não conseguiu fazer, antes de falar de componentes.

Frase Uso
Customers were unable to complete payments between 14:05 and 14:50 UTC. Impacto em função do usuário
A subset of customers in the São Paulo region was affected. Escopo parcial
The service was degraded, but not fully unavailable. Diferenciar lentidão de parada
Checkout was unavailable for about forty minutes. Duração aproximada
Internal tools were not affected. Delimitar o que ficou de fora
We have found no evidence of data loss so far. Cautela sobre dados
We are still assessing the full scope of the impact. Impacto ainda em avaliação

Duas cautelas. A primeira é a quantificação. Se você tem um número verificado, use. Se não tem, diga "approximately" ou "we are still measuring". Nunca invente uma porcentagem para parecer preciso. A segunda é a frase sobre dados. "No data was lost" é uma afirmação forte. Só a faça depois de verificar. Antes disso, "We have found no evidence of data loss so far" diz a mesma coisa com a ressalva honesta.

Fase 3: mitigação

É a fase em que há mais verbos, porque você descreve ações. Prefira verbos concretos a verbos vagos. "We did a change" não diz nada. "We rolled back the release" diz tudo.

Frase Ação
We rolled back the release at 14:25. Reverter a versão
We failed over to the secondary database. Trocar para o sistema reserva
We disabled the feature flag. Desligar a funcionalidade
We restarted the affected services. Reiniciar
We scaled up the cluster to handle the load. Aumentar capacidade
We applied a temporary workaround while we prepare a permanent fix. Solução temporária
Service is recovering. Estado em andamento
Error rates returned to normal at 14:50 UTC. Estado final observável
We are monitoring the situation. Fase de observação

"Roll back" é o phrasal verb (duas palavras, verbo). O substantivo é "rollback", uma palavra só. "We rolled back the release" e "We performed a rollback" são corretas. "We made a rollback" funciona na fala, mas "performed" ou "did" soam mais naturais para muitos ouvintes.

Existe uma distinção útil entre dizer que o serviço foi restaurado e dizer que o problema foi corrigido. "Service was restored at 14:50" é uma afirmação sobre o estado observável. "The issue is fixed" é uma afirmação sobre a causa. Se só a primeira é verdadeira, só ela deve ser dita.

Fase 4: causa raiz

Esta é a fase em que se pesa cada palavra. A causa raiz exige análise, e análise leva tempo. Durante o incidente, o mais honesto é dizer o que se tem: sinais, hipóteses, achados preliminares.

Frase Uso
The root cause was a misconfigured connection pool. Causa confirmada
The trigger was a configuration change deployed at 14:00 UTC. O evento que disparou o problema
The underlying cause was that the change was not validated in staging. Causa de fundo
A contributing factor was that we had no alert for this condition. Fator que agravou
Preliminary findings suggest that the database ran out of connections. Achado ainda não confirmado
We believe the issue was caused by a recent release. Hipótese declarada
We are still investigating the root cause. Causa ainda desconhecida

Observe a separação entre trigger e root cause. O gatilho é o que aconteceu naquela hora: uma mudança de configuração, um pico de tráfego, um certificado que venceu. A causa raiz é a razão pela qual o gatilho pôde derrubar o serviço: a mudança não foi validada, o sistema não tinha limite de carga, ninguém monitorava a data do certificado. Muitos incidentes têm mais de uma causa, e é por isso que existe a expressão "contributing factors". Dizer "the root cause was John's change" confunde o gatilho com a causa e, de quebra, aponta um culpado.

Para expressar graus de certeza, use uma escala: "we know", "we believe", "we suspect", "we don't know yet". Cada nível é uma promessa diferente. "We know" quer dizer que há evidência. "We suspect" quer dizer que há um indício. Usar "we know" por segurança, quando só há suspeita, é o tipo de coisa que volta contra você no post-mortem.

Fase 5: ações de acompanhamento

Termina com o que será feito. Ações têm verbo, objeto, responsável e prazo. Se faltar um desses, não é uma ação, é uma intenção.

Frase Uso
We will add an alert for connection pool exhaustion. Ação concreta
We are adding a validation step to the deployment pipeline. Ação em andamento
Each action item has an owner and a due date. Dizer que há responsáveis
We will share the full post-mortem by Friday. Compromisso de documento
These changes should reduce the chance of this happening again. Cautela sobre prevenção
We will review the on-call process next week. Revisão de processo

A última cautela da fase é essa: nunca prometa que "this will never happen again". Ninguém pode garantir isso. "Reduce the chance of this happening again" é a frase honesta, e engenheiros experientes a reconhecem como tal.

Atualizações durante o incidente

Durante o incidente, a comunicação segue um ritmo. Muitos times usam, na página de status, rótulos padronizados de estágio: investigating, identified, monitoring e resolved. Eles dizem ao leitor em que ponto o problema está sem exigir que leia o texto inteiro.

Estágio Significado Exemplo de atualização
Investigating Sabemos que há um problema, não sabemos a causa We are investigating reports of failed payments. Next update in thirty minutes.
Identified Temos a causa ou uma hipótese forte We have identified the cause and are rolling back the release.
Monitoring A ação foi feita, observamos o resultado Service has been restored. We are monitoring to confirm stability.
Resolved O problema acabou The incident has been resolved. A post-mortem will follow.

Duas práticas valem para qualquer atualização. A primeira é sempre dizer quando será a próxima: "Next update in thirty minutes" ou "Next update at 15:00 UTC". Isso reduz as perguntas, porque quem espera sabe quando voltar a olhar. A segunda é usar a mesma estrutura toda vez: o que sabemos, o que não sabemos, o que estamos fazendo, quando falamos de novo.

Quando você é chamado de surpresa numa chamada de incidente e não tem tempo de preparar, esta fórmula de três partes funciona: "Here is what I know. Here is what I don't know yet. Here is the next step." Por exemplo: "Here is what I know: the payments API started returning errors at 14:05, and we rolled back the last release at 14:25. Here is what I don't know yet: why the release caused the errors. Next step: we are reading the database logs, and I'll update you at 15:00."

Falar com engenheiros e falar com executivos

O mesmo fato se diz de dois jeitos, conforme quem ouve. O engenheiro quer o mecanismo. O executivo quer o efeito e o que está sendo feito. Se você responder ao executivo com o mecanismo, ele perde o fio. Se responder ao engenheiro só com o efeito, ele vai achar que você está escondendo algo.

Para engenheiros Para executivos
The connection pool was exhausted because the new release held connections open. A software update caused the payment system to stop accepting requests.
We rolled back the release and the error rate dropped to baseline. We reversed the update and the service returned to normal.
Latency on the primary database spiked after the failover. The system was slow for about twenty minutes after we switched to the backup.
We have no alerting on pool saturation. We did not have an early warning for this kind of failure.
The change bypassed staging because of a flag in the pipeline. The change was not tested in our test environment before it went live.

Para o executivo, três perguntas dominam: quem foi afetado, quanto dura, o que fazemos. Se você responder essas três antes de ser perguntado, a conversa fica curta. Para o engenheiro, as perguntas são diferentes: o que mudou, o que os logs mostram, o que descartamos. Saber quem está na chamada é metade da preparação.

Tom: seco, factual, sem culpa

O tom de uma comunicação de incidente tem três regras. Não dramatize. Não minimize. Não aponte culpados.

Dramatizar é dizer "this is a disaster" ou "we are in a critical situation" sem dados que o sustentem. Minimizar é dizer "it's just a small issue" quando clientes não conseguem pagar. As duas coisas corroem a credibilidade, uma por exagerar e a outra por esconder. A saída é descrever o fato: quem foi afetado, por quanto tempo, o que foi feito.

Apontar culpados é o erro que mais danifica a cultura de um time. O formato aceito em boa parte da indústria é o post-mortem sem culpados, em inglês "blameless post-mortem". A premissa é que as pessoas agem dentro de um sistema, e que, se uma pessoa pôde causar um incidente com uma ação razoável, o problema está no sistema que permitiu isso. A linguagem acompanha: o sujeito da frase é o processo, a mudança ou o componente, e não a pessoa.

Evite Prefira
It's just a small issue. The issue affects checkout for some customers.
Hopefully it's fixed. Error rates are back to normal. We are monitoring.
It should be fine now. We restored service and will confirm after thirty minutes of stable metrics.
Someone broke production. A change deployed at 14:00 caused the outage.
It was a human error. The deployment process allowed an unvalidated change to reach production.
We don't know why. We don't know the cause yet. We are reading the database logs.
This will never happen again. We are taking steps to reduce the chance of this happening again.

Uma palavra pequena que merece atenção é "just". "It was just a configuration change" tira o peso de algo que derrubou o serviço. Corte a palavra. E "hopefully", que em português parece uma cortesia, em comunicação de incidente soa como insegurança. Se você não sabe, diga que não sabe. Se sabe, afirme.

Sobre o pedido de desculpas, aos clientes. Uma desculpa factual e curta é suficiente: "We apologize for the disruption." Ou: "We're sorry for the impact this had on you." Evite excesso. Uma desculpa longa, cheia de adjetivos, vira ruído. Peça desculpas, descreva o que aconteceu, diga o que mudará.

Pedir ajuda e escalar

Durante o incidente, saber pedir ajuda com clareza economiza minutos. A frase vaga "we need help" faz o interlocutor perguntar de quê. A frase específica já traz a resposta.

Frase Uso
I need a second pair of eyes on these logs. Pedir revisão
Can we get someone from the database team on the call? Chamar outra equipe
I'm escalating this to the platform team. Escalar
Who owns this service? Descobrir o responsável
Does anyone have context on the last deployment? Buscar contexto
I'll take the lead on communication. Can you focus on the fix? Dividir papéis
Let's take the root cause discussion offline and focus on recovery. Adiar a análise
I'm stepping away for ten minutes. Maria will cover. Passar o bastão

"Take it offline" quer dizer discutir fora da reunião. É uma frase útil quando a chamada se perde em debate sobre a causa enquanto o serviço continua fora do ar. A prioridade, numa chamada de incidente, é recuperar. A análise vem depois.

Estrutura de um post-mortem

O post-mortem, também escrito "postmortem" e, em alguns times, chamado de "incident review", é o documento que registra o que aconteceu e o que foi aprendido. Cada empresa tem seu modelo, mas as seções se repetem. Esta é uma estrutura comum, que serve de ponto de partida.

Seção O que contém
Summary Resumo de poucas linhas: o que ocorreu, duração e impacto
Impact Quem foi afetado, em quê e por quanto tempo
Timeline Cronologia com horários
Detection Como o problema foi detectado e se a detecção foi rápida
Response O que foi feito, por quem, em que ordem
Root cause Gatilho, causa de fundo e fatores contribuintes
What went well O que funcionou na resposta
What went wrong O que falhou
Where we got lucky Circunstâncias favoráveis que não eram garantidas
Action items Ações com responsável e prazo

A seção "Where we got lucky" é a menos óbvia e uma das mais úteis. Ela registra o que poderia ter piorado o incidente e não piorou por acaso: o engenheiro certo estava de plantão, o problema ocorreu fora do horário de pico, o backup tinha sido testado na semana anterior. Se a sorte foi o que impediu um problema maior, a sorte não é um controle.

A cronologia é escrita em frases curtas, com horário no começo e verbo no passado.

O estilo é seco de propósito. Nada de adjetivos, nada de interpretação na cronologia. A interpretação fica nas seções de causa e de ações.

Um parágrafo de resumo, no mesmo estilo: "On the fourteenth, customers were unable to complete payments for approximately forty-five minutes. A configuration change deployed at 14:00 UTC caused the payments service to exhaust its database connections. We detected the issue through an automated alert at 14:05 UTC and restored service by rolling back the change at 14:25 UTC. We have found no evidence of data loss. The action items below address validation of configuration changes and alerting on connection usage."

Os números e horários desse exemplo são fictícios. Use os seus, e só os verificados.

Erros comuns de brasileiros em comunicações de incidente

Alguns erros se repetem. Nenhum é grave isoladamente, mas, juntos, deixam a comunicação menos clara.

Erro comum Forma natural
The system is out of the air. The system is down.
We solved the bug in production. We fixed the bug in production.
We are making a rollback. We are rolling back the release.
The deploy have a problem. The deployment had a problem.
The service was normalized. Service was restored.
Production is stopped. Production is unavailable.
We are seeing the logs. We are looking at the logs.
We have the same problem since yesterday. We have had the same problem since yesterday.

Vale explicar alguns. "Out of the air" é tradução literal de "fora do ar" e não existe em inglês técnico. "Normalized" não é a forma usual de dizer que o serviço voltou ao normal; prefira "restored" ou "recovered". "Since yesterday" pede o presente perfeito, "have had", e não o presente simples. E "solve" funciona bem com problemas em geral, mas para defeitos de código a escolha natural é "fix".

Pronúncia de palavras que travam em chamada

Muitos termos de TI são usados em português com pronúncia adaptada, e isso funciona entre brasileiros. Numa chamada com estrangeiros, o som precisa ser outro. Uso aproximações em português, com a sílaba forte em maiúsculas.

Palavra Pronúncia aproximada Observação
deploy di-PLÓI Acento na segunda sílaba.
cache CÉSH Soa como "cash", dinheiro. Não é "ca-RRÊ".
queue QUIÚ A palavra inteira soa como a letra Q.
latency LÊI-ten-si Acento na primeira sílaba.
rollback RÔUL-béc Acento na primeira sílaba.
failover FÊIL-ôu-ver Acento na primeira sílaba.
mitigate MÍ-ti-gueit Três sílabas.
incident ÍN-si-dent Acento na primeira sílaba.
severity se-VÉ-ri-ti Acento na segunda sílaba.
resolved ri-ZÓLVD O "s" soa como "z".

Mesmo estas aproximações são só um ponto de partida. Antes de usar um termo novo numa chamada importante, ouça o áudio em um dicionário. A pronúncia de siglas também varia: "SQL" pode ser lido como "ess-cue-ell" ou "sequel", e as duas formas circulam. Siga a que o seu time usa.

Para onde ir daqui

Se o seu trabalho é de TI e você precisa falar inglês em chamadas de incidente, dailies, revisões e reuniões com a matriz, o Inglespetacular Executive de TI traz o vocabulário e as situações da área. Cada Executive Journey tem 10 unidades, 70 lições e cerca de 480 termos, e o Speak tem 750 linhas de fala para você praticar em voz alta. O curso exige B1 completo, tem o preço informado na página do curso, e a Introdução e a Unidade 1 são grátis. Veja o curso em Executive de TI.

Dois guias irmãos completam este. O de termos de TI em inglês reúne o vocabulário por área. O de como participar de uma daily em inglês trata da rotina do time, onde também se fala de bloqueios e de pedir ajuda. Para termos avulsos, consulte o glossário de TI.

Eu escrevo e reviso. Se encontrar algo errado, avise.

Perguntas frequentes

Qual é a diferença entre "mitigate", "resolve" e "fix"?

Mitigar é reduzir o impacto sem eliminar a causa, como voltar uma versão. Resolver é encerrar o incidente ou eliminar a causa, conforme o contexto. Fix é corrigir um defeito específico. Use o verbo que corresponde ao que de fato aconteceu.

"Post-mortem", "postmortem" ou "incident review"?

As três formas existem. As duas primeiras são variações de grafia. "Incident review" é o nome que alguns times preferem. Use o que a sua empresa usa.

Preciso dar um ETA quando não sei?

Não. É melhor dizer: "We don't have an ETA yet. Next update in thirty minutes." O horário da próxima atualização é o que você pode garantir, e é o que o ouvinte precisa.

Como me desculpar com um cliente?

De forma curta e factual: "We apologize for the disruption." Depois, o que aconteceu e o que muda. Desculpas longas e adjetivadas atrapalham.

Posso chamar um incidente de "bug"?

Em geral, não. Bug é um defeito no código. Incidente é o evento que afeta o serviço, que pode ter um bug como causa, mas também pode vir de infraestrutura, configuração, tráfego ou terceiros.

Com que frequência devo atualizar durante um incidente?

Não há regra universal. Combine um ritmo com a equipe e com os interessados, e diga sempre quando será a próxima atualização. Se não houver novidade, diga isso: "No change since the last update. We are still investigating."

Como lidar com a pressão de ser chamado de surpresa?

Use a fórmula de três partes: o que sei, o que não sei, o próximo passo. Ela organiza a fala e evita palpites.

Comece pela Unidade 1, de graça

A Introdução e a Unidade 1 de cada curso são grátis, com cadastro. Se não souber seu nível, faça o teste antes.

Para treinar isso

Continue lendo