Noções básicas de CLI para Node

10 exemplos para curl, jq, ss e rastreamento de logs em servidores Linux executando APIs Node.js - 7 básicos e 3 intermediários.

Pré-requisitos

• Acesso SSH a uma VM/host de contêiner de staging ou produção (função somente leitura para juniores).
• curl, jq e ss instalados (padrão na maioria das imagens Linux).
• Conheça a porta do seu serviço (3000 padrão) e a rota de saúde (/health).

Exemplos Básicos

1. Verificação de Saúde com curl

curl -sf http://localhost:3000/health
curl -sf http://localhost:3000/ready

• -s silencioso, -f falha em HTTP 4xx/5xx (saída não zero)
• Use em probes de balanceador de carga e scripts de implantação de fumaça
• ready deve falhar quando Postgres/Redis estiverem inacessíveis

# Com tempo para triagem de latência
curl -sf -w "time_total=%{time_total}\n" -o /dev/null http://localhost:3000/health

2. POST JSON para uma API

curl -sf -X POST http://localhost:3000/orders \
  -H "Content-Type: application/json" \
  -H "x-request-id: cli-smoke-$(date +%s)" \
  -d '{"customerId":"550e8400-e29b-41d4-a716-446655440000","items":[{"sku":"550e8400-e29b-41d4-a716-446655440001","quantity":1}]}'

• Sempre envie x-request-id para correlação de logs
• Canalize através de jq para saída legível: | jq .

3. Filtrar Logs JSON com jq

# Últimas 100 linhas de erro da saída padrão do contêiner
kubectl logs deploy/orders-api --tail=500 | jq -c 'select(.level=="error")' | tail -20
 
# Rastrear uma solicitação
kubectl logs deploy/orders-api --since=10m | jq -c 'select(.requestId=="abc-123")'

• Logs Pino são um objeto JSON por linha - perfeito para jq
• select(.statusCode >= 500) para erros HTTP em eventos request_complete

Relacionado: pino - convenções de campos de log

4. Listar Portas de Escuta com ss

ss -tlnp | grep node
ss -tlnp 'sport = :3000'

• ss substitui netstat obsoleto em Linux moderno
• Confirme se o Node está vinculado a 0.0.0.0:3000, não apenas 127.0.0.1 em contêineres
• Verifique o acúmulo de TIME-WAIT sob carga: ss -s

5. Rastrear Journal systemd para Serviço Node

sudo journalctl -u orders-api -f --since "15 min ago"
sudo journalctl -u orders-api -p err --since today

• -f segue logs ao vivo em VMs sem Kubernetes
• Combine com systemctl status orders-api para loops de reinicialização

6. Seguir Logs de Contêiner Docker

docker logs -f --tail 200 orders-api
docker logs orders-api 2>&1 | jq -c 'select(.level=="error")' | tail -10

• Aplicativos Node registram na saída padrão - o Docker a captura
• Não use docker exec para ler arquivos de log que não existem

7. Verificação de DNS e Upstream do Servidor

curl -sf https://api.stripe.com/v1/charges -H "Authorization: Bearer sk_test_xxx" -o /dev/null -w "%{http_code}\n"
getent hosts postgres.internal

• Distinga bug do aplicativo vs falha de rede/DNS durante incidentes
• Execute do mesmo namespace de rede que o pod do aplicativo, quando possível

Exemplos Intermediários

8. Script de Verificação no Repositório

#!/usr/bin/env bash
set -euo pipefail
BASE_URL="${BASE_URL:-http://localhost:3000}"
 
curl -sf "$BASE_URL/health" | jq -e '.status == "ok"'
curl -sf "$BASE_URL/ready" | jq -e '.status == "ok"'
echo "smoke OK"

• Confirme em bin/smoke.sh; execute pós-implantação em CI ou SSH
• set -euo pipefail falha rapidamente no primeiro erro

Relacionado: Melhores Práticas de CLI do Linux - higiene de scripts

9. Comparar Cabeçalhos de Resposta (Cache, Autenticação)

curl -sI http://localhost:3000/orders/1 | grep -iE 'cache-control|x-request-id|content-type'

• -I requisição HEAD apenas para metadados
• Verifique cabeçalhos de CDN/cache em rotas GET

10. Verificação Pontual de Carga com Loop curl

for i in $(seq 1 20); do
  curl -sf -o /dev/null -w "%{http_code} %{time_total}\n" http://localhost:3000/health
done

• Verificação manual rápida antes de declarar o incidente resolvido
• Para testes de carga reais, use k6 ou autocannon, não loops bash em produção

FAQs

Relacionados

• Inspeção de Processos - top, lsof
• Melhores Práticas de CLI do Linux - resumo portátil
• Habilidade de Triagem de Incidentes - comandos de incidentes

Versões da Stack: Esta página foi escrita para Node.js 24.18.0 (LTS Ativo), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 e NestJS 11.