[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M786CH2CDREDNAFBYNJCM302":3,"skill-same:01M786CH2CDREDNAFBYNJCM302":47},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M786CH2CDREDNAFBYNJCM302","observability",null,"allanpablo\u002Fforja","allanpablo","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22358346?v=4","01M786AH79M6N27CC4HZ2AHJTQ","Allan Pablo","01M786AH80CPCTFFMSTRMGEGYF",2,"MIT","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fobservability\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: observability\ndescription: Use quando preparar um serviço ou funcionalidade para produção: deriva SLIs e SLOs dos requisitos não funcionais, planeja métricas, logs estruturados e traces, e define alertas baseados em sintomas, cada um com um esboço de runbook.\n---\n\n# Observabilidade\n\nUm sistema é observável quando você consegue responder a uma pergunta nova sobre o comportamento dele em produção sem publicar código novo. O objetivo não são dashboards: é saber que os usuários estão sofrendo antes que eles avisem, e descobrir o porquê rápido.\n\nA saída padrão é um **plano de observabilidade**: SLOs, sinais e alertas. Escreva código de instrumentação só quando o usuário pedir.\n\n## Convenções\n\n- Entradas: `RNF-NN` mensuráveis de `requirements-gathering`; endpoints de `api-design`; classificação de dados pessoais de `lgpd-compliance`; eventos de segurança de `threat-modeling`.\n- Siga o código existente: a biblioteca de log, o backend de métricas e a configuração de tracing. Use [OpenTelemetry](https:\u002F\u002Fopentelemetry.io\u002F) e suas convenções semânticas como padrão quando não houver nada.\n- Tráfego, metas ou escalas de plantão desconhecidos vão para **Perguntas em aberto**. Não invente metas de SLO; derive-as ou pergunte.\n\n## SLIs e SLOs\n\n- Um **SLI** mede o que o usuário experimenta, como a razão entre eventos bons e eventos válidos: disponibilidade (respostas não-5xx \u002F todas as respostas), latência (requisições abaixo de X ms \u002F todas as requisições), atualidade, correção.\n- Um **SLO** é a meta de um SLI numa janela: \"99,5% dos `POST \u002Forders` abaixo de 300 ms em 28 dias\".\n- Derive cada SLO de um `RNF-NN`. Quando o requisito não for mensurável, devolva-o para `requirements-gathering`.\n- O **orçamento de erro** (100% − SLO) é o que os alertas e as decisões de release consomem.\n- Poucos SLOs, nas jornadas de usuário que importam. Não um por endpoint.\n\n## Métricas\n\n- **RED** para serviços guiados por requisições: Taxa (Rate), Erros, Duração (como histograma, nunca média).\n- **USE** para recursos: Utilização, Saturação, Erros (pools, filas, CPU, memória).\n- **Métricas de negócio** que dizem se a funcionalidade funciona: pedidos criados, pagamentos que falharam.\n- Só labels com cardinalidade limitada: template da rota, método, classe do status. Nunca IDs de usuário, e-mails ou URLs cruas.\n\n## Logs\n\n- Estruturados (JSON), um evento por linha, com `timestamp`, `level`, `message`, `service`, `trace_id` e os identificadores de domínio necessários para investigar (ID do pedido, não o nome do cliente).\n- Os níveis significam algo: `error` exige ação; `warn` é inesperado mas tratado; `info` é um evento de negócio ou de ciclo de vida; `debug` fica desligado em produção.\n- **Nada de dados pessoais, segredos ou tokens** nos logs (conforme `lgpd-compliance`). Quando for preciso um identificador, use um ID pseudônimo.\n- Registre nas fronteiras e nas decisões, não em toda linha. Registre cada erro uma vez, onde ele é tratado.\n- Os eventos de segurança de `threat-modeling` (falhas de autenticação, permissões negadas, acionamentos do limite de taxa) são registrados com o ator e o objeto.\n\n## Traces\n\n- Propague o contexto em toda fronteira: HTTP, filas, jobs (W3C Trace Context).\n- Spans para requisições de entrada, chamadas de saída, consultas ao banco e operações de fila, com atributos semânticos.\n- Amostre por taxa, mas mantenha todos os traces de erro e os lentos quando o backend suportar amostragem na cauda (tail sampling).\n\n## Alertas\n\n- Alerte sobre **sintomas** que os usuários sentem (taxa de consumo do SLO), não sobre causas (CPU em 80%).\n- Use alertas de taxa de consumo com múltiplas janelas: consumo rápido aciona plantão (por exemplo, 2% do orçamento em 1 h), consumo lento abre um ticket (por exemplo, 10% em 3 dias).\n- Todo acionamento de plantão é acionável, urgente e precisa de um humano. O resto é ticket ou dashboard.\n- Todo alerta aponta para um esboço de runbook: o que significa, primeiras verificações, mitigação, escalonamento.\n\n## Formato\n\n```\n## SLOs\n| SLO | SLI (bons \u002F válidos) | Meta | Janela | Origem |\n|---|---|---|---|---|\n| Latência de criação de pedido | POST \u002Forders \u003C 300 ms \u002F todos os POST \u002Forders | 99,5% | 28d | RNF-03 |\n\n## Métricas\n| Nome | Tipo | Labels | Finalidade |\n\n## Logs\n\u003Ceventos por caso de uso: nível, mensagem, campos>\n\n## Traces\n\u003Cfronteiras instrumentadas, amostragem>\n\n## Alertas\n| Alerta | Condição | Severidade (plantão\u002Fticket) | Runbook |\n\n## Esboços de runbook\n### \u003CAlerta>\nSignificado: … Primeiras verificações: … Mitigação: … Escalonamento: …\n\n## Perguntas em aberto\n```\n\n## Próximo\n\n- `testing`: verifique que os eventos de negócio críticos e os erros são registrados e medidos.\n- `pull-request`: liste os sinais e alertas novos em \"O quê\".\n\n## Evite\n\n- Alertar sobre toda métrica de causa.\n- Médias para latência.\n- Labels de alta cardinalidade.\n- Dados pessoais, segredos ou corpos inteiros de requisição em logs ou atributos de span.\n- SLOs em 100%, ou metas tiradas do nada.\n- Dashboards que ninguém olha em vez de alertas que importam.\n","# Observabilidade\n\nUm sistema é observável quando você consegue responder a uma pergunta nova sobre o comportamento dele em produção sem publicar código novo. O objetivo não são dashboards: é saber que os usuários estão sofrendo antes que eles avisem, e descobrir o porquê rápido.\n\nA saída padrão é um **plano de observabilidade**: SLOs, sinais e alertas. Escreva código de instrumentação só quando o usuário pedir.\n\n## Convenções\n\n- Entradas: `RNF-NN` mensuráveis de `requirements-gathering`; endpoints de `api-design`; classificação de dados pessoais de `lgpd-compliance`; eventos de segurança de `threat-modeling`.\n- Siga o código existente: a biblioteca de log, o backend de métricas e a configuração de tracing. Use [OpenTelemetry](https:\u002F\u002Fopentelemetry.io\u002F) e suas convenções semânticas como padrão quando não houver nada.\n- Tráfego, metas ou escalas de plantão desconhecidos vão para **Perguntas em aberto**. Não invente metas de SLO; derive-as ou pergunte.\n\n## SLIs e SLOs\n\n- Um **SLI** mede o que o usuário experimenta, como a razão entre eventos bons e eventos válidos: disponibilidade (respostas não-5xx \u002F todas as respostas), latência (requisições abaixo de X ms \u002F todas as requisições), atualidade, correção.\n- Um **SLO** é a meta de um SLI numa janela: \"99,5% dos `POST \u002Forders` abaixo de 300 ms em 28 dias\".\n- Derive cada SLO de um `RNF-NN`. Quando o requisito não for mensurável, devolva-o para `requirements-gathering`.\n- O **orçamento de erro** (100% − SLO) é o que os alertas e as decisões de release consomem.\n- Poucos SLOs, nas jornadas de usuário que importam. Não um por endpoint.\n\n## Métricas\n\n- **RED** para serviços guiados por requisições: Taxa (Rate), Erros, Duração (como histograma, nunca média).\n- **USE** para recursos: Utilização, Saturação, Erros (pools, filas, CPU, memória).\n- **Métricas de negócio** que dizem se a funcionalidade funciona: pedidos criados, pagamentos que falharam.\n- Só labels com cardinalidade limitada: template da rota, método, classe do status. Nunca IDs de usuário, e-mails ou URLs cruas.\n\n## Logs\n\n- Estruturados (JSON), um evento por linha, com `timestamp`, `level`, `message`, `service`, `trace_id` e os identificadores de domínio necessários para investigar (ID do pedido, não o nome do cliente).\n- Os níveis significam algo: `error` exige ação; `warn` é inesperado mas tratado; `info` é um evento de negócio ou de ciclo de vida; `debug` fica desligado em produção.\n- **Nada de dados pessoais, segredos ou tokens** nos logs (conforme `lgpd-compliance`). Quando for preciso um identificador, use um ID pseudônimo.\n- Registre nas fronteiras e nas decisões, não em toda linha. Registre cada erro uma vez, onde ele é tratado.\n- Os eventos de segurança de `threat-modeling` (falhas de autenticação, permissões negadas, acionamentos do limite de taxa) são registrados com o ator e o objeto.\n\n## Traces\n\n- Propague o contexto em toda fronteira: HTTP, filas, jobs (W3C Trace Context).\n- Spans para requisições de entrada, chamadas de saída, consultas ao banco e operações de fila, com atributos semânticos.\n- Amostre por taxa, mas mantenha todos os traces de erro e os lentos quando o backend suportar amostragem na cauda (tail sampling).\n\n## Alertas\n\n- Alerte sobre **sintomas** que os usuários sentem (taxa de consumo do SLO), não sobre causas (CPU em 80%).\n- Use alertas de taxa de consumo com múltiplas janelas: consumo rápido aciona plantão (por exemplo, 2% do orçamento em 1 h), consumo lento abre um ticket (por exemplo, 10% em 3 dias).\n- Todo acionamento de plantão é acionável, urgente e precisa de um humano. O resto é ticket ou dashboard.\n- Todo alerta aponta para um esboço de runbook: o que significa, primeiras verificações, mitigação, escalonamento.\n\n## Formato\n\n```\n## SLOs\n| SLO | SLI (bons \u002F válidos) | Meta | Janela | Origem |\n|---|---|---|---|---|\n| Latência de criação de pedido | POST \u002Forders \u003C 300 ms \u002F todos os POST \u002Forders | 99,5% | 28d | RNF-03 |\n\n## Métricas\n| Nome | Tipo | Labels | Finalidade |\n\n## Logs\n\u003Ceventos por caso de uso: nível, mensagem, campos>\n\n## Traces\n\u003Cfronteiras instrumentadas, amostragem>\n\n## Alertas\n| Alerta | Condição | Severidade (plantão\u002Fticket) | Runbook |\n\n## Esboços de runbook\n### \u003CAlerta>\nSignificado: … Primeiras verificações: … Mitigação: … Escalonamento: …\n\n## Perguntas em aberto\n```\n\n## Próximo\n\n- `testing`: verifique que os eventos de negócio críticos e os erros são registrados e medidos.\n- `pull-request`: liste os sinais e alertas novos em \"O quê\".\n\n## Evite\n\n- Alertar sobre toda métrica de causa.\n- Médias para latência.\n- Labels de alta cardinalidade.\n- Dados pessoais, segredos ou corpos inteiros de requisição em logs ou atributos de span.\n- SLOs em 100%, ou metas tiradas do nada.\n- Dashboards que ninguém olha em vez de alertas que importam.\n",{},"main","cfe29d604e93a4c19fd25db4289328f6ec17bb41","templates\u002Fproject\u002Fskills\u002Fobservability",0,"https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja","npmjs.com\u002Fforjajs","https:\u002F\u002Fgithub.com\u002Fallanpablo","www.allanpablo.com.br","Gestor de TI","2026-11-15 05:12:58",{"source":7,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add allanpablo\u002Fforja --skill observability",{"tool":39,"command":40},"bunx","bunx skills add allanpablo\u002Fforja --skill observability",{"tool":42,"command":43},"pnpm","pnpm dlx skills add allanpablo\u002Fforja --skill observability","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fobservability\u002FSKILL.md",true,[],[48,54,60,66,72,78],{"skillNo":49,"name":50,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":18},"01M786DTCHHV8K0MZMQQA2N81Q","web-performance","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fweb-performance\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":18},"01M786DQ9FDGFMJTF6WANNJ7QG","ts-testing","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fts-testing\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":18},"01M786DMASM9PXP0NSEZYTHA7Q","ts-module-layout","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fts-module-layout\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":18},"01M786DH4Y3AD551JN35D2R3HY","ts-code-review","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fts-code-review\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":18},"01M786DF1R7PCK6KB44B34110S","ts-async-patterns","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fts-async-patterns\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":18},"01M786DDCF8GHQ8KY2X4DGY3XN","threat-modeling","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fthreat-modeling\u002FSKILL.md",[],[]]