# Native Observability — Status Block

The **Native Observability Status Block** module provides a real-time
administrative overview of the Native Observability system directly inside
the Drupal interface.

It exposes operational information through a Drupal block that can be placed
in any administrative layout, allowing administrators and developers to
quickly verify the status of the observability system.

This module is part of the **Native Observability ecosystem** and requires
the base module `native_observability`.

---

# 🎯 Purpose

Observability systems should not only collect data, they should also provide
clear operational visibility.

The Status Block module provides a quick way to understand:

- if the observability system is active
- if trace recording is working
- if metrics aggregation is running
- if telemetry exporters are available

All of this information is exposed directly inside the Drupal admin UI.

---

# 🚀 Features

### Observability Status Block

Provides a Drupal block displaying the current status of the observability system.

Information can include:

- trace recording status
- metrics engine availability
- telemetry exporters availability
- diagnostics information
- system health indicators

---

### Admin Interface Integration

The block can be placed inside the Drupal administration interface to provide
real-time operational information.

Typical placements include:

- administration dashboard
- observability report pages
- developer administration layouts

---

### Diagnostics Integration

The block integrates with the Native Observability diagnostics services to
display runtime checks and system indicators.

This allows administrators to quickly verify that the observability stack
is operating correctly.

---

# 🧩 Architecture

The module integrates with the following Native Observability services:

- observability diagnostics services
- trace recorder infrastructure
- metrics engine
- telemetry exporters

The block retrieves runtime information from these services and renders a
summary view for administrators.

---

# 📦 Requirements

This module requires:

- Drupal 11
- `native_observability` (core module)

Optional integrations are available when the following modules are enabled:

- `native_observability_metrics`
- `native_observability_otel`
- `native_observability_execution`

---

# ⚙️ Installation

Enable the module using Drush:

```bash
drush en native_observability_status_block
