O sanalytics é a ferramenta oficial de linha de comando para criar, testar e publicar funções no Analytics Lab diretamente do terminal.
Instalação e configuração
1. Download do binário
Acesse o GitHub para baixar o binário correspondente ao seu ambiente (macOS, Linux ou Windows).
2. Criar atalho no sistema
Para utilizar o comando sanalytics globalmente no terminal a partir de qualquer diretório:
No Linux e macOS, o comando cria um link simbólico no diretório /usr/local/bin.
3. Autenticação
Obtenha o seu token no painel em Configurações > Lab e realize a autenticação:
Comandos disponíveis
Detalhes dos comandos
sanalytics env
Gerencia segredos e variáveis de ambiente injetados na sandbox durante a execução da função. Os valores são criptografados com AES-256-GCM no servidor e nunca são expostos na listagem.
Se executado dentro da pasta do projeto da função, o sanalytics identifica a função automaticamente pelo sanalytics.json. Para executar de fora, use a flag --function <slug-ou-id>.
sanalytics create
Inicia o assistente interativo para configurar e gerar a estrutura local da função:
O terminal solicitará as informações básicas para criar o projeto:
- Nome do projeto / pasta: Nome do diretório local onde os arquivos serão gerados.
- Linguagem / Runtime: Escolha entre Node.js (
node22) ou Python (python3.12).
sanalytics test
Compacta o diretório local, envia para o ambiente sandbox do Lab, instala as dependências declaradas e executa o handler. Retorna a duração total, tempo de cold start e a saída do console.
sanalytics deploy
Empacota o código local e publica uma nova versão oficial (v1, v2, etc.) no Analytics Lab.
sanalytics download
Baixa os arquivos-fonte da versão ativa de uma função para o diretório local: