# Planejador de orçamento de latência de API Planeje e visualize um orçamento de latência de API. Insira um alvo P99 (ex. ≤ 300ms) e a alocação por estágio (DNS, TCP, TLS, TTFB, Processing, Network) para ver um waterfall ao vivo, a utilização do orçamento e alertas de excesso. Opcionalmente cole um trace OpenTelemetry ou Datadog para deduzir uma alocação medida. > Página canônica: https://elysiatools.com/pt/tools/api-latency-budget-planner - **Categoria:** Development - **Palavras-chave:** orçamento de latência, slo, p99, waterfall, opentelemetry, datadog, trace, orçamento de desempenho, api, ttfb, estágios de requisição, sre, observabilidade, apm ## Visão geral Um planejador de SLO / orçamento de desempenho para SREs e designers de API: 1. **Orçamento total** — defina o alvo P99 (ex. 300ms). Opcionalmente escolha um rótulo de objetivo (P50/P90/P99/P99.9) mostrado no resumo. 2. **Alocação por estágio** — liste cada estágio e seu orçamento em ms, um por linha, ex. `DNS=5`, `TLS=20`, `TTFB=80`, `Processing=120`. 3. **Waterfall** — um gráfico de barras colorido mostra a parcela de cada estágio. Estágios acima de 35% são marcados em vermelho. 4. **Margem e excesso** — o resumo informa quanto do orçamento foi usado e se você está dentro ou acima do alvo, com uma sugestão de realocação proporcional. 5. **Importar trace** — cole um trace OpenTelemetry ou Datadog (JSON) e a ferramenta extrai as durações por span, agrupa por nome e sugere uma alocação inicial baseada em medidas reais. Tudo é calculado localmente no navegador. ## Entradas - **Orçamento total de latência (P99, ms)** (number): The overall latency target in milliseconds (e.g. 300 for P99 ≤ 300ms). - **Alocação por estágio (nome=ms, um por linha)** (textarea): One stage per line as name=ms (also accepts name: ms or name ms). - **Objetivo de nível de serviço** (select) - **Cole o trace (OpenTelemetry / Datadog JSON, opcional)** (textarea): Optional OpenTelemetry or Datadog trace JSON. The tool extracts per-span durations to suggest an allocation. ## Quando usar - Ao projetar novas APIs e definir acordos de nível de serviço (SLAs) ou objetivos de nível de serviço (SLOs) de latência. - Durante a depuração de gargalos de desempenho para identificar quais etapas da requisição estão consumindo a maior parte do tempo limite aceitável. - Ao analisar traces de execução do OpenTelemetry ou Datadog para converter medições reais em um orçamento de latência estruturado. ## Como funciona - Defina o orçamento total de latência em milissegundos e selecione o objetivo de nível de serviço desejado (P50, P90, P99 ou P99.9). - Insira a alocação de tempo estimada para cada estágio da requisição (como DNS, TCP, TLS e processamento) no formato nome=valor, uma por linha. - Opcionalmente, cole um trace JSON do OpenTelemetry ou Datadog para extrair automaticamente as durações reais de cada span. - Visualize instantaneamente o gráfico waterfall, identifique etapas críticas destacadas em vermelho e analise as sugestões de realocação caso o orçamento seja excedido. ## Casos de uso - Definição de SLOs de latência P99 para microsserviços antes de sua implementação em produção. - Análise de gargalos de rede e processamento comparando o planejado com traces reais do Datadog. - Otimização de handshakes TLS e conexões TCP em gateways de API globais. ## Perguntas frequentes ### Como a ferramenta calcula o uso do orçamento? Ela soma os tempos de todos os estágios inseridos e compara com o orçamento total definido, exibindo a porcentagem utilizada e a margem restante. ### O que significa o destaque em vermelho no gráfico waterfall? Qualquer estágio individual que consuma mais de 35% do orçamento total de latência é destacado em vermelho para indicar um potencial gargalo. ### Posso importar dados diretamente de ferramentas de APM? Sim, você pode colar traces formatados em JSON exportados do OpenTelemetry ou Datadog para extrair as durações dos spans automaticamente. ### Os dados do meu trace são enviados para algum servidor? Não. Todos os cálculos e o processamento dos traces JSON são realizados localmente no seu navegador, garantindo total privacidade. ### O que a ferramenta faz se o orçamento for estourado? Ela exibe um alerta de excesso de orçamento e fornece uma sugestão de realocação proporcional para ajudar a ajustar os tempos de cada estágio. ## Ferramentas relacionadas - [Gerador de Snippets de Requisicoes API](https://elysiatools.com/pt/tools/api-request-code-snippet-generator): Gera cURL e snippets em linguagens comuns a partir de URL, metodo, cabecalhos, query e corpo da requisicao - [Auditor de dependências do package.json](https://elysiatools.com/pt/tools/package-json-dependency-auditor): Audita um package.json quanto à higiene de dependências e qualidade das faixas de versão, e opcionalmente inspeciona a árvore transitiva a partir de package-lock.json ou yarn.lock. Sinaliza duplicatas, wildcard ou pre-release, chaves desordenadas, metadados ausentes e dependências runtime/dev mal classificadas. - [Visualizador de Plano de Execução SQL](https://elysiatools.com/pt/tools/sql-explain-plan-visualizer): Cole a saída do EXPLAIN / EXPLAIN ANALYZE (PostgreSQL/MySQL/SQLite) para renderizar uma árvore de custos, marcar divergências entre linhas estimadas e reais e sugerir índices - [GraphQL Playground](https://elysiatools.com/pt/tools/graphql-playground): Cliente GraphQL no navegador: escreva queries e variáveis, envie para qualquer endpoint GraphQL e inspecione resultados JSON formatados ou arrays de erros — ideal para iterar sobre esquemas durante o desenvolvimento - [Conversor de logs para diagramas de sequencia](https://elysiatools.com/pt/tools/log-sequence-diagram-converter): Converte logs estruturados de servicos em diagramas Mermaid ou PlantUML com anotacoes de latencia e erro - [Gerador de OpenAPI para TypeScript](https://elysiatools.com/pt/tools/openapi-to-typescript-generator): Converte especificacoes OpenAPI ou Swagger em JSON/YAML em tipos TypeScript, parametros de requisicao e modelos de resposta com formato de saida e estilo de nomes configuraveis - [Nota Segura de Compartilhamento AGEX](https://elysiatools.com/pt/tools/agex-secure-share-note): Gera uma nota clara para que o destinatario saiba como descriptografar e verificar um bundle AGEX - [Planejador de migracao CSV para banco de dados](https://elysiatools.com/pt/tools/csv-to-database-migration-planner): Infere um schema relacional a partir de CSV e gera planos CREATE TABLE e ALTER para PostgreSQL, MySQL, SQLite ou SQL Server ## Exemplos - [Coleções Postman - Testes de API](https://elysiatools.com/pt/samples/postman-collections): Exemplos abrangentes de coleções Postman incluindo testes de API, scripts de automação, variáveis de ambiente, servidores mock e padrões avançados de teste para REST APIs - [Exemplos de Rastreamento Distribuído](https://elysiatools.com/pt/samples/distributed-tracing-samples): Exemplos completos de rastreamento distribuído usando Jaeger, OpenTelemetry e ferramentas modernas de observabilidade - [Exemplos New Relic APM](https://elysiatools.com/pt/samples/newrelic-samples): Configuração completa New Relic Application Performance Monitoring incluindo instrumentação, dashboards e alertas - [Exemplos AWS EventBridge](https://elysiatools.com/pt/samples/eventbridge-samples): Exemplos AWS EventBridge incluindo event buses, regras, targets, schema registry, eventos personalizados e roteamento de eventos entre contas para arquitetura serverless event-driven ## Conteúdo relacionado - [Ferramentas de Replay de Requisicoes API, Snippets e Debug em Runtime](https://elysiatools.com/pt/hubs/api-request-replay-and-debugging): Reune conversao de cURL para codigo, captura e replay de webhooks, verificacao HMAC, diff de respostas, auditoria de headers, inspecao TLS e depuracao do caminho real de uma requisicao API. - [Ferramentas de intercambio JSON e traducao de formatos](https://elysiatools.com/pt/hubs/json-convert): Compare ferramentas de conversao JSON para CSV, YAML, TOML, GraphQL, XML, Markdown, Excel, BSON, EDN e outros formatos estruturados em um unico hub. - [Ferramentas de inspecao, diff e transformacao JSON](https://elysiatools.com/pt/hubs/json-utility): Reune em um so hub ferramentas para formatar JSON, comparar mudancas, inspecionar caminhos, validar schema, mesclar arquivos e transformar dados para fluxos de API e dados. - [Geradores de schema JSON, dados mock e fixtures de API](https://elysiatools.com/pt/hubs/json-generate): Ferramentas reunidas para geracao de schema JSON, construcao de payloads mock e preparacao de fixtures de API em um unico hub.