O que são Blueprints?
Cada blueprint inclui:- Recomendações de estrutura de eventos: Nomenclatura de eventos e design de metadados ideais
- Configuração de medição: Tipos de agregação e filtros sugeridos
- Código de exemplo: Exemplos de implementação funcional em várias linguagens
- Melhores práticas: Dicas para precisão, desempenho e otimização de custos
Por que usar Blueprints?
Faster Setup
Faça o rastreamento de uso funcionar em minutos em vez de horas. Copie padrões comprovados em vez de projetar do zero.
Best Practices Built In
Evite erros comuns com estruturas de eventos testadas, metadados apropriados e escolhas de agregação ideais.
Production Ready
O código de exemplo baseia-se em implementações reais. Basta adicionar suas chaves de API e começar.
Blueprints Disponíveis
Escolha o blueprint que corresponde ao seu caso de uso:LLM Blueprint
Monitore o uso de tokens de IA em OpenAI, Anthropic, Groq, Gemini, Vercel AI SDK e mais.Perfeito para: Chatbots de IA, geradores de código, ferramentas de criação de conteúdo, aplicativos com IA.O que você rastreará: tokens de entrada, tokens de saída, uso de modelo, contagens de solicitações.
API Gateway Blueprint
Mensure solicitações de API no nível do gateway com filtragem de endpoint e suporte a limitação de taxa.Perfeito para: APIs REST, serviços GraphQL, provedores de webhook, plataformas API-first.O que você rastreará: contagens de solicitações, uso de endpoints, métodos HTTP, tempos de resposta.
Object Storage Blueprint
Monitore uploads de arquivos, consumo de armazenamento e largura de banda para serviços de armazenamento em nuvem.Perfeito para: Hospedagem de arquivos, plataformas de mídia, serviços de backup, gerenciamento de documentos.O que você rastreará: bytes armazenados, uploads de arquivos, downloads, snapshots de armazenamento.
Stream Blueprint
Meça a largura de banda de streaming para vídeo, áudio e entrega de dados em tempo real.Perfeito para: Streaming de vídeo, plataformas de áudio, transmissões ao vivo, feeds de dados em tempo real.O que você rastreará: largura de banda consumida, duração do fluxo, níveis de qualidade, fluxos simultâneos.
Time Range Blueprint
Fature pelo tempo decorrido para recursos de computação, funções serverless e jobs de longa duração.Perfeito para: Plataformas serverless, hospedagem de contêineres, instâncias de computação, processamento em lote.O que você rastreará: tempo de execução, horas de computação, invocações de função, duração do job.
Como Usar um Blueprint
Choose your blueprint
Selecione o blueprint que melhor se adequa ao seu cenário de cobrança. Cada página de blueprint inclui guias detalhados de implementação.
Review the event structure
Compreenda a nomenclatura recomendada para eventos e o design de metadados. Copie a estrutura de eventos para o seu caso de uso.
Create the meter
Siga as instruções de configuração do medidor do blueprint. Use o tipo de agregação e os filtros sugeridos.
Implement event sending
Copie o código de exemplo para sua linguagem/framework. Substitua os valores de espaço reservado por suas chaves de API e IDs de cliente reais.
Test and verify
Envie eventos de teste e verifique se eles aparecem no painel do medidor com a agregação correta.
Comparação de Blueprints
Não tem certeza de qual blueprint atende às suas necessidades? Aqui está uma comparação rápida:| Caso de Uso | Blueprint | Agregação | Metadados Comuns |
|---|---|---|---|
| App de chat de IA | LLM | Soma (tokens) | model, input_tokens, output_tokens |
| API REST | API Gateway | Contagem | endpoint, method, status_code |
| Armazenamento de arquivos | Object Storage | Soma (bytes) | file_size, file_type, operation |
| Plataforma de vídeo | Stream | Soma (largura de banda) | duration, quality, bitrate |
| Serverless | Time Range | Soma (duração) | function_name, execution_time_ms |
Implementações Personalizadas
Não vê um blueprint para seu caso de uso exato? Sem problemas:- Comece com o blueprint mais próximo: Escolha o que mais se assemelha às suas necessidades
- Adapte a estrutura do evento: Modifique os campos de metadados para corresponder às suas exigências
- Ajuste a configuração de medição: Altere o tipo de agregação ou filtros conforme necessário
- Teste minuciosamente: Verifique os cálculos de faturamento com o uso de amostra
Todos os blueprints são pontos de partida. Sinta-se à vontade para misturar conceitos de blueprints diferentes ou criar implementações totalmente personalizadas.