THE BLACK BOX

>> DECODING THE OBSERVABILITY STACK

01. The Signal Flow (Architecture)

graph TD %% Styling classDef cloud fill:#222,stroke:#fff,stroke-width:2px; classDef shield fill:#003366,stroke:#00aaff,stroke-width:3px; classDef brain fill:#330000,stroke:#ff0044,stroke-width:3px; classDef sensor fill:#333300,stroke:#ffff00,color:#fff; User(You 🥷) subgraph "ORACLE VPS (The Brain)" Gateway -->|Port 3000| Grafana(Grafana) %% The Data Loop Grafana <-->|Query| Prometheus Grafana <-->|Query| Loki %% The Collectors Prometheus <-->|Scrape| NodeExp(Node Exporter) Prometheus <-->|Scrape| Cadvisor(cAdvisor) %% The Logs Promtail(Promtail) -->|Push Logs| Loki end class Grafana,Prometheus,Loki brain; class NodeExp,Cadvisor,Promtail sensor; click Grafana "https://grafana.txikitins.com" "Open Grafana"

⚡ The Sensors

  • Node Exporter: Watches the Metal (CPU, RAM). Mounts /host to see real hardware.
  • cAdvisor: Watches Docker Containers (RAM/CPU per container).

🤖 The Agents

  • Promtail: The "Mailman". Tails log files and ships them to Loki.

🏛️ The Core

  • Prometheus: Rolling Database (15 days). PULL model.
  • Loki: Log Aggregator. PUSH model. Indexed by labels.

🛠️ "No Data" Protocol

If you see empty graphs, check the pipeline:


Step Command / Check
1. Is Sensor Alive? docker ps | grep ninja_node_exporter
2. Can Brain Reach? curl -s http://localhost:9090/api/v1/targets
3. Grafana Settings Check Data Source (Prometheus) & Time Range.