install-openserve/README.md

100 lines
5.5 KiB
Markdown

# install-openserve
Script para instalação e configuração automática do **agente OpenObserve** (OpenTelemetry Collector) em servidores Linux, VMs e containers LXC.
## Compatibilidade
- Qualquer distribuição Linux com `systemd` (Ubuntu, Debian, etc.)
- VMs e containers LXC do Proxmox
## Configuração padrão
| Item | Valor |
|-------------------------------|-------------------------------------------------------------------|
| Endpoint de ingestão | `https://openobserve.ledcloud.com.br/api/<org_id>/` |
| Organização | LED Cloud |
| Autenticação | Token de ingestão (Base64), gerado em **Dados > Fontes de dados > Gerenciar tokens** |
| Serviço instalado | `otel-collector` (binário `otelcol-contrib`) |
| Arquivo de configuração | `/etc/otel-config.yaml` |
| Identificação do host | `host.name` = hostname curto da máquina (detectado automaticamente) |
## Uso
Execute como **root** na máquina que vai enviar dados:
```bash
wget -O openobserve-install.sh https://git.ledcloud.com.br/LED_Cloud/install-openserve/raw/branch/main/openobserve-install.sh
chmod +x openobserve-install.sh
sudo ./openobserve-install.sh
```
Ou, se o repositório já estiver clonado localmente:
```bash
git clone https://git.ledcloud.com.br/LED_Cloud/install-openserve.git
cd install-openserve
chmod +x openobserve-install.sh
sudo ./openobserve-install.sh
```
O script pergunta interativamente pela **URL de ingestão** e pelo **token em Base64** (cole exatamente o valor mostrado na tela "Gerenciar tokens", sem editar). Para rodar sem prompts (automação, rollout em massa), use variáveis de ambiente:
```bash
sudo OO_URL="https://openobserve.ledcloud.com.br/api/<org_id>/" \
OO_AUTH_B64="<token_base64_copiado_da_tela>" \
./openobserve-install.sh
```
Variável opcional:
- `OO_HOSTNAME` — nome que vai aparecer em **Infra > Hosts**. Padrão: hostname curto da máquina (`hostname -s`).
## O que o script faz
1. Confere se está rodando como root.
2. Valida que o token colado em `OO_AUTH_B64` é Base64 válido (evita erros silenciosos de 401 por valor colado errado).
3. Se o coletor ainda não estiver instalado, baixa o instalador oficial do OpenObserve e instala o `otelcol-contrib` com a URL e o token informados.
4. Se já estiver instalado, só reconfigura: faz backup do `/etc/otel-config.yaml` antes de qualquer alteração.
5. Grava o header `Authorization: Basic <token>` em **todos** os exporters do arquivo de configuração, usando o valor exatamente como foi colado (sem recodificar).
6. Fixa `host.name` no processor `resource/hostname`, garantindo que o host apareça com o nome correto em **Infra > Hosts**, mesmo em containers LXC onde as métricas de recurso podem se confundir com as do nó físico.
7. Valida a configuração (`otelcol-contrib validate`) antes de reiniciar o serviço — se a validação falhar, nada é reiniciado.
8. Reinicia e habilita o serviço `otel-collector`.
9. Aguarda alguns segundos e verifica nos logs se não há mais erros `401` (autenticação), avisando se algo ainda estiver incorreto.
## Observações
- O script precisa ser executado como root (`sudo`).
- É seguro executar o script mais de uma vez na mesma máquina: ele detecta se o coletor já está instalado e apenas atualiza a configuração, sem reinstalar o binário.
- **Nunca** recombine o token com e-mail nem gere um novo Base64 em cima do valor copiado da tela "Gerenciar tokens" — o valor já vem pronto para o header `Authorization` e qualquer recodificação quebra a autenticação (erro 401).
- Se aparecerem erros `401` persistentes nos logs (`journalctl -u otel-collector`), confira se o token ainda está ativo em **Gerenciar tokens** e se foi colado sem espaços ou quebras de linha.
- Trate o token de ingestão como uma credencial: não o cole em canais públicos nem o deixe em scripts versionados. Se ele for exposto, revogue-o e gere um novo.
## Rollout em massa (LXCs e VMs de um host Proxmox)
Para instalar em muitos containers LXC de uma vez, use `deploy-openobserve-fleet.sh`, executado **no próprio host Proxmox** como root, na mesma pasta onde está `openobserve-install.sh`:
```bash
wget -O deploy-openobserve-fleet.sh https://git.ledcloud.com.br/LED_Cloud/install-openserve/raw/branch/main/deploy-openobserve-fleet.sh
chmod +x deploy-openobserve-fleet.sh
sudo OO_URL="https://openobserve.ledcloud.com.br/api/<org_id>/" \
OO_AUTH_B64="<token_base64_copiado_da_tela>" \
./deploy-openobserve-fleet.sh
```
Ele lista todos os LXCs (`pct list`), pede confirmação e, para cada container em execução, copia o `openobserve-install.sh` com `pct push`, executa com `pct exec` em modo não interativo e remove o arquivo temporário ao final. Ao término, mostra um resumo de quais hosts tiveram sucesso, foram pulados ou falharam.
Variáveis opcionais:
- `SKIP_LXC_IDS` — IDs de LXC a pular, separados por espaço (ex.: `"105 112"`).
- `VM_SSH_HOSTS` — lista de IPs/hosts de VMs para instalar também via SSH (requer chave SSH configurada para root), separados por espaço.
Exemplo incluindo VMs:
```bash
sudo OO_URL="https://openobserve.ledcloud.com.br/api/<org_id>/" \
OO_AUTH_B64="<token_base64>" \
VM_SSH_HOSTS="10.0.0.11 10.0.0.12" \
SKIP_LXC_IDS="105" \
./deploy-openobserve-fleet.sh
```