Skip to main content
O Broadcast envia automaticamente os traces das solicitações da API AIHubMix para uma plataforma externa de observabilidade configurada. Assim, você pode monitorar, depurar e analisar o uso de LLM no LangWatch sem adicionar instrumentação ao código da aplicação. Atualmente, o AIHubMix oferece suporte ao LangWatch como destino do Broadcast. Após a configuração, o LangWatch exibe modelo, uso de tokens, custo real cobrado, latência, sessão e informações de Trace.

​
Pré-requisitos

  • Uma chave de API AIHubMix ativa
  • Uma conta LangWatch e o Project de destino
  • Acesso ao console do AIHubMix
Esta integração usa a Project API Key existente do Project de destino, no formato sk-lw-*. Chaves com escopo de organização ou equipe e a credencial pkey_* de Personal OTLP Endpoint não são aceitas nesta configuração. O AIHubMix usa atualmente o endpoint oficial do LangWatch Cloud e não oferece suporte a instâncias auto-hospedadas.

​
  1. Obter a LangWatch Project API Key

  1. Entre no LangWatch e selecione o Project que receberá os traces do AIHubMix.
  2. Abra Settings → API Keys.
  3. Localize Project API Key, confirme que o Scope é o Project de destino e selecione o botão de cópia.
Não é necessário criar uma nova Secret Key. O AIHubMix usa a Project API Key fornecida com o Project.
Project API Key nas configurações do LangWatch

​
  1. Adicionar um destino LangWatch

  1. Abra AIHubMix Observability.
  2. Em Add destination, selecione LangWatch.
Destino LangWatch na página AIHubMix Observability
  1. Preencha as configurações.
O cabeçalho x-session-id e o campo user são transmitidos com o registro para relacionar sessões ou usuários no LangWatch.
Configurações do destino LangWatch no AIHubMix

​
Testar e salvar

  1. Selecione Test. Após a conexão, o botão exibe Connected.
  2. Selecione Add destination para salvar o destino.
  3. Confirme que o destino está ativado e com status OK.
Use Save changes para alterações posteriores.
Destino LangWatch com status OK no AIHubMix

​
  1. Enviar uma solicitação de verificação

Confirme que AIHUBMIX_API_KEY já esteja definida no shell atual e envie uma solicitação normal ao modelo.
cURL
Os registros são entregues de forma assíncrona. Uma Trace pode levar alguns segundos para aparecer no LangWatch.

​
  1. Verificar no LangWatch

  1. Abra Traces no Project de destino.
  2. Procure o modelo usado, x-session-id ou user.
  3. Confirme latência, custo, tokens e informações do modelo.
Chamada da API AIHubMix no LangWatch Traces
Com Privacy ativado, colunas de conteúdo como Prompt ficam vazias, enquanto latência, custo, tokens e modelo permanecem disponíveis.
Colunas de conteúdo vazias no LangWatch com Privacy

​
Solução de problemas

​
Test retorna 401

Use a Project API Key do Project de destino. Não use pkey_* de Personal OTLP Endpoint nem chaves com escopo de organização ou equipe.

​
O destino foi salvo, mas nenhuma Trace aparece

Confirme que o destino está ativado com status OK, Sampling rate é maior que 0% e o filtro inclui a chave de API AIHubMix usada. Aguarde alguns segundos e atualize Traces.

​
Privacy remove as métricas

Privacy impede apenas o envio do texto de prompt e completion. Tokens, custo real cobrado, latência e modelo continuam sendo enviados.
Última atualização: 2026-08-25