Pular para o conteúdo principal

Visão geral

Conecte o Axiom à Leme com um API token do Axiom. Depois da conexão, a Leme pode ajudar seu time a inspecionar dados de observabilidade em agents e fluxos compatíveis. O suporte atual de Axiom para agents é focado em leitura: a Leme pode listar datasets, ler fields de datasets e executar queries APL.
Use API tokens do Axiom, não Personal Access Tokens. API tokens permitem menor privilégio; PATs dão controle amplo demais sobre a conta.

Pré-requisitos

  • Um workspace ativo na Leme.
  • Permissão para conectar integrações compartilhadas no workspace.
  • Um API token do Axiom no formato xaat-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
O token precisa ter permissão para listar datasets, porque a Leme verifica esse acesso antes de concluir a configuração.

Criar o token no Axiom

  1. Acesse o workspace do Axiom.
  2. Abra as configurações de tokens.
  3. Crie um API token avançado.
  4. Conceda somente as permissões necessárias para o uso esperado.
  5. Copie o token gerado. Ele deve começar com xaat-.
Para usar o suporte atual de Axiom na Leme, o token deve permitir:
  • listar datasets;
  • ler fields de datasets;
  • executar queries APL.

Conectar na Leme

  1. No dashboard da Leme, abra Connections.
  2. Selecione Axiom.
  3. Mantenha o edge padrão, a menos que o administrador do Axiom tenha informado um edge regional.
  4. Cole o API token.
  5. Clique em Conectar Axiom.
A Leme valida o token antes de salvar a conexão. Se o token for inválido ou não tiver permissões suficientes, a configuração exibirá um erro. Depois que a configuração for concluída, vincule a conexão Axiom aos agents que devem usá-la e confirme que as policies de uso relevantes estão habilitadas.

Configuração de edge

A maioria dos times pode manter o valor padrão api. Altere somente quando o administrador do Axiom informar que as queries devem usar um edge regional.
EdgeUse quando
apiVocê não sabe qual edge usar, ou seu workspace usa o edge padrão.
us-east-1.aws.edgeO administrador do Axiom informou o edge US East 1.
eu-central-1.aws.edgeO administrador do Axiom informou o edge EU Central 1.
Se queries falharem depois da configuração, confirme o edge com o administrador do Axiom e reconecte com o valor correto.

Permissões recomendadas

Para usar o suporte atual de Axiom na Leme, crie um API token que possa:
  • listar datasets;
  • ler fields de datasets;
  • executar queries APL.
Limite o token aos datasets que a Leme deve poder consultar.

Notas de segurança

A Leme armazena o API token com segurança e não mostra o token novamente depois da configuração. Rotacione o token no Axiom se ele for exposto, se o dono do token sair da empresa ou se o modelo de permissões mudar.

Solução de problemas

Token recusado antes de chamar o Axiom

Confirme que o token começa com xaat- e segue o formato de API token do Axiom.

A configuração falha durante a validação

O token provavelmente não tem permissão para listar datasets. Crie um API token com permissão de leitura de datasets ou use outro token com escopo suficiente.

Query falha depois da conexão

Verifique se o edge selecionado corresponde ao ambiente do dataset e se o token tem permissão para a ação solicitada.

A conexão não aparece para um agent

Confirme que a conexão Axiom está vinculada ao agent e que as policies de uso permitem a ação desejada.