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?
Configuração Mais Rápida
Faça o rastreamento de uso funcionar em minutos em vez de horas. Copie padrões comprovados em vez de projetar do zero.
Melhores Práticas Integradas
Evite erros comuns com estruturas de eventos testadas, metadados adequados e escolhas de agregação ideais.
Pronto para Produção
O código de exemplo é baseado em implementações do mundo real. Basta adicionar suas chaves de API e começar.
Blueprints Disponíveis
Escolha o blueprint que corresponde ao seu caso de uso:Blueprint LLM
Rastreie 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ê irá rastrear: Tokens de entrada, tokens de saída, uso do modelo, contagem de solicitações.
Blueprint de API Gateway
Meça solicitações de API no nível do gateway com suporte a filtragem de endpoints e limitação de taxa.Perfeito para: APIs REST, serviços GraphQL, provedores de webhook, plataformas API-first.O que você irá rastrear: Contagem de solicitações, uso de endpoints, métodos HTTP, tempos de resposta.
Blueprint de Armazenamento de Objetos
Rastreie 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ê irá rastrear: Bytes armazenados, uploads de arquivos, downloads, instantâneas de armazenamento.
Blueprint de Stream
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ê irá rastrear: Largura de banda consumida, duração do stream, níveis de qualidade, streams simultâneos.
Blueprint de Intervalo de Tempo
Fature pelo tempo decorrido para recursos de computação, funções serverless e trabalhos de longa duração.Perfeito para: Plataformas serverless, hospedagem de contêineres, instâncias de computação, processamento em lote.O que você irá rastrear: Tempo de execução, horas de computação, invocações de função, duração do trabalho.
Como Usar um Blueprint
1
Escolha seu blueprint
Selecione o blueprint que melhor corresponde ao seu cenário de faturamento. Cada página de blueprint inclui guias de implementação detalhadas.
2
Revise a estrutura do evento
Entenda a nomenclatura de eventos recomendada e o design de metadados. Copie a estrutura do evento para seu caso de uso.
3
Crie a medição
Siga as instruções de configuração de medição do blueprint. Use o tipo de agregação e filtros sugeridos.
4
Implemente o envio de eventos
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.
5
Teste e verifique
Envie eventos de teste e verifique se eles aparecem no seu painel de medição com a agregação correta.
6
Personalize conforme necessário
Adapte o blueprint às suas necessidades específicas—adicione metadados personalizados, ajuste filtros ou modifique preços.
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 diferentes blueprints ou criar implementações totalmente personalizadas.