DashDescomplicar/okf/entidades/Monitorizacao-Gemini.md

type, layer, tags, title

type	layer	tags	title
Entity	wiki	stack dashdescomplicar infra monitorizacao gemini telemetria	Monitorizacao-Gemini

Monitorizacao-Gemini

Sistema de telemetria para hooks do Gemini CLI. Recolhe métricas de tool calls do Gemini e escreve no mesmo ficheiro JSONL usado pelo Claude Code para métricas unificadas.

Responsabilidades

• Hook AfterTool: Captura tool_name, session_id, success/error, duration
• Formato Unificado: Escreve em ~/.claude-work/tool-invocations.jsonl com campo engine: gemini
• Pré-Telemetria: Script gemini-pre-telemetry.py regista timestamp de início para cálculo de duração
• Health Check: gemini-health.sh verifica conectividade do Gemini CLI

Stack

• Python 3: Scripts de hook (piped via stdin/stdout do Gemini CLI)
• Formato: JSONL (compatível com Claude Code)
• Ficheiro: ~/.claude-work/tool-invocations.jsonl

Scripts

Script	Função	Trigger
gemini-telemetry.py (2.3KB)	Hook AfterTool — captura e regista métricas	Gemini CLI after tool call
gemini-pre-telemetry.py (1.0KB)	Hook BeforeTool — regista timestamp início	Gemini CLI before tool call
gemini-health.sh (1.0KB)	Health check conectividade Gemini	Manual/agendado

Formato de Log

{
  "ts": "2026-06-30T12:00:00Z",
  "session": "<session_id>",
  "tool_name": "read_file",
  "success": true,
  "error": "",
  "duration": 1.23,
  "engine": "gemini"
}

Localizações

• Scripts: Dev/DashDescomplicar/monitorizacao/ (3 ficheiros)
• Output: ~/.claude-work/tool-invocations.jsonl
• Temp: ~/.gemini/tmp/telemetry/<session_id>.start

Dependências

• Gemini CLI: Pipe stdin/stdout para hooks Python
• Sistema de Ficheiros: ~/.claude-work/, ~/.gemini/tmp/

Fornece a

• Observabilidade-Sessions: Dados de telemetria Gemini unificados com Claude
• Sistema IA: Métricas cross-engine (Claude + Gemini + Hermes + OpenCode)