> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Gerar dados sintéticos do OpenTelemetry com otelgen > Use o otelgen para enviar logs, traces e métricas sintéticos para um coletor OpenTelemetry do ClickStack [`otelgen`](https://github.com/krzko/otelgen) é uma pequena CLI escrita em Go que gera logs, traces e métricas sintéticos via OTLP. Use-o para confirmar que um coletor OpenTelemetry do ClickStack já está aceitando dados e que os eventos aparecem na UI do ClickStack. Este guia pressupõe que o coletor já esteja em execução com endpoints OTLP nas portas `4317` (gRPC) e `4318` (HTTP). ### Pré-requisitos Este guia pressupõe que você já concluiu o [guia de introdução do Managed ClickStack](/pt-BR/clickstack/deployment/managed) e tem um coletor OpenTelemetry em execução, com os endpoints OTLP gRPC (`4317`) e HTTP (`4318`) acessíveis a partir da máquina em que você executa o `otelgen`. Se você [protegeu o coletor](/pt-BR/clickstack/ingesting-data/collector#securing-the-collector) com um `OTLP_AUTH_TOKEN`, mantenha esse valor em mãos. ### Instale o otelgen Instale com Homebrew: ```shell theme={null} brew install krzko/tap/otelgen ``` Ou instale com Go: ```shell theme={null} go install github.com/krzko/otelgen@latest ``` ### Defina as variáveis de ambiente Exporte o endpoint do coletor e, se ele estiver protegido, o token de autenticação: ```shell theme={null} export OTEL_ENDPOINT=:4317 export OTLP_AUTH_TOKEN= ``` Use o host e a porta do seu coletor. Para um coletor em execução na mesma máquina, use `localhost:4317`. **Coletor sem autenticação** O ClickStack OpenTelemetry collector não exige autenticação por padrão. Se você não seguiu [Securing the collector](/pt-BR/clickstack/ingesting-data/collector#securing-the-collector) para definir um `OTLP_AUTH_TOKEN`, ignore `OTLP_AUTH_TOKEN` aqui e remova a flag `--header` dos comandos abaixo. ### Gere traces Envie uma curta sequência de traces com múltiplos spans: ```shell theme={null} otelgen --otel-exporter-otlp-endpoint ${OTEL_ENDPOINT} \ --header "authorization=${OTLP_AUTH_TOKEN}" \ --protocol grpc --insecure \ --rate 2 --duration 10 \ traces multi ``` `--rate` é o número de traces por segundo, e `--duration` é a duração da execução em segundos. `--insecure` desativa o TLS na conexão gRPC, o que é necessário ao apontar o `otelgen` para a porta OTLP sem criptografia do coletor. ### Gere logs ```shell theme={null} otelgen --otel-exporter-otlp-endpoint ${OTEL_ENDPOINT} \ --header "authorization=${OTLP_AUTH_TOKEN}" \ --protocol grpc --insecure \ --rate 2 --duration 10 \ logs multi ``` ### Gere métricas Os subcomandos de métricas não respeitam `--duration`. Execute o comando e pressione `Ctrl+C` após alguns segundos para interrompê-lo. ```shell theme={null} otelgen --otel-exporter-otlp-endpoint ${OTEL_ENDPOINT} \ --header "authorization=${OTLP_AUTH_TOKEN}" \ --protocol grpc --insecure \ --rate 2 \ metrics sum ``` O `otelgen` também oferece suporte aos subcomandos `gauge`, `histogram`, `up-down-counter` e `exponential-histogram` em `metrics`. ### Verifique no ClickStack Abra a UI do ClickStack no console do ClickHouse Cloud. Na visualização `Busca`, alterne a `source` entre `Logs` e `Traces` para confirmar os novos eventos. Defina o intervalo de tempo como `Last 15 minutes`. Abra o `Chart Explorer`, selecione `Metrics` e crie um gráfico com um dos nomes de métricas produzidos pelo `otelgen` (por exemplo, `otelgen.metrics.sum`) para verificar a ingestão de métricas. ### Pré-requisitos Este guia pressupõe que você iniciou o Open Source ClickStack usando as [instruções para a imagem all-in-one](/pt-BR/clickstack/getting-started/oss) e que os endpoints OTLP (`4317` gRPC e `4318` HTTP) estão acessíveis. Você também precisa da API key de ingestão na UI do HyperDX, em `Team Settings > API Keys`. ### Instalar o otelgen Instale com Homebrew: ```shell theme={null} brew install krzko/tap/otelgen ``` Ou instale com Go: ```shell theme={null} go install github.com/krzko/otelgen@latest ``` ### Definir variáveis de ambiente Exporte o endpoint do coletor e a API key de ingestão: ```shell theme={null} export OTEL_ENDPOINT=localhost:4317 export CLICKSTACK_API_KEY= ``` ### Gerar traces Envie uma curta sequência de traces com múltiplos spans: ```shell theme={null} otelgen --otel-exporter-otlp-endpoint ${OTEL_ENDPOINT} \ --header "authorization=${CLICKSTACK_API_KEY}" \ --protocol grpc --insecure \ --rate 2 --duration 10 \ traces multi ``` `--rate` é o número de traces por segundo, e `--duration` é a duração da execução em segundos. `--insecure` habilita gRPC em plaintext no coletor local. ### Gerar logs ```shell theme={null} otelgen --otel-exporter-otlp-endpoint ${OTEL_ENDPOINT} \ --header "authorization=${CLICKSTACK_API_KEY}" \ --protocol grpc --insecure \ --rate 2 --duration 10 \ logs multi ``` ### Gerar metrics Os subcomandos de metrics não respeitam `--duration`. Execute o comando e pressione `Ctrl+C` após alguns segundos para interrompê-lo. ```shell theme={null} otelgen --otel-exporter-otlp-endpoint ${OTEL_ENDPOINT} \ --header "authorization=${CLICKSTACK_API_KEY}" \ --protocol grpc --insecure \ --rate 2 \ metrics sum ``` O `otelgen` também oferece suporte aos subcomandos `gauge`, `histogram`, `up-down-counter` e `exponential-histogram` em `metrics`. ### Verificar no ClickStack Acesse [http://localhost:8080](http://localhost:8080) para abrir a ClickStack UI. Na visualização `Busca`, alterne a `source` entre `Logs` e `Traces` para confirmar novos eventos. Defina o intervalo de tempo como `Last 15 minutes`. Abra o `Chart Explorer`, selecione `Metrics` e crie um chart com um dos nomes de metric gerados pelo `otelgen` (por exemplo, `otelgen.metrics.sum`) para verificar a ingestão de metrics.