Skip to main content

Grafana Dashboard

The AxonFlow Community Dashboard provides real-time visibility into your AI governance platform's security, performance, and policy enforcement metrics.

Quick Start

The dashboard is automatically loaded when you start AxonFlow with docker-compose:

docker compose up -d

# Access Grafana
open http://localhost:3000
# Login: admin / grafana_localdev456 (default)

Navigate to Dashboards → AxonFlow → AxonFlow Community to view the dashboard.

Dashboard Sections

Overview

Key metrics at a glance:

PanelDescription
Total RequestsTotal API requests processed
Blocked RequestsRequests blocked by security policies
Policy EvaluationsNumber of policy evaluations performed
Success RatePercentage of allowed requests
P95 Pre-check Latency95th percentile gateway pre-check time
LLM Tokens TrackedTotal LLM tokens processed

Security & Compliance

Real-time security monitoring panels:

PanelTypeDescription
PII Detections by TypeBar ChartBreakdown of detected PII by type (Aadhaar, PAN, UPI, bank accounts, etc.)
Security Threats BlockedStatTotal blocked requests including SQL injection, PII leaks, and dangerous queries
Provider DistributionPie ChartDistribution of Gateway Mode LLM audit calls by provider (OpenAI, Anthropic, Google, Azure, Ollama)
Active Policies SummaryBar ChartPolicy enforcement activity - evaluations vs blocks vs PII detections

Request Throughput

Traffic analysis panels:

PanelDescription
Request RateRequests per second by status and component
Blocked Requests RateBlocked requests over time by component

Latency

Performance monitoring panels:

PanelDescription
Gateway Pre-check LatencyP50/P95/P99 for policy pre-check operations
Agent Request LatencyP50/P95/P99 for agent processing
Orchestrator Request LatencyP50/P95/P99 for orchestrator operations

Policy Enforcement

Policy activity panels:

PanelDescription
Policy Activity (Hourly)Policy evaluations and blocked requests over time
Gateway Pre-check ResultsPie chart showing approved vs blocked ratio

LLM Usage

LLM monitoring panels:

PanelDescription
LLM Tokens (5m)Token usage by type (input/output)
LLM Cost (Hourly)Cost tracking by provider and model
LLM API Calls (5m)API calls by provider and status

MCP Connectors

Connector monitoring panels:

PanelDescription
Connector Calls (5m)Requests by connector type
Connector LatencyP50/P95 latency by connector
Connector Errors (5m)Error tracking by connector and type

Auto-Provisioning

The dashboard is automatically provisioned when Grafana starts. No manual import required.

Configuration files:

  • config/grafana/provisioning/datasources/prometheus.yml - Prometheus datasource
  • config/grafana/provisioning/dashboards/dashboards.yml - Dashboard provisioning
  • config/grafana/dashboards/axonflow-community.json - Dashboard definition

Key Prometheus Metrics

These metrics power the dashboard panels:

Agent Metrics

MetricLabelsDescription
axonflow_agent_requests_totalstatusTotal requests by status
axonflow_agent_blocked_requests_total-Blocked requests
axonflow_agent_policy_evaluations_total-Policy evaluations
axonflow_agent_request_duration_milliseconds_bucket-Request latency histogram

Gateway Metrics

MetricLabelsDescription
axonflow_gateway_precheck_requests_totalapprovedPre-check requests
axonflow_gateway_precheck_duration_milliseconds_bucket-Pre-check latency
axonflow_gateway_rbi_pii_detected_totalpii_type, blockedPII detections by type
axonflow_gateway_llm_tokens_totaltypeLLM token tracking
axonflow_gateway_llm_cost_usd_totalprovider, modelLLM cost tracking

Orchestrator Metrics

MetricLabelsDescription
axonflow_orchestrator_requests_totalstatusTotal requests
axonflow_orchestrator_blocked_requests_total-Blocked requests
axonflow_orchestrator_policy_evaluations_total-Policy evaluations
axonflow_orchestrator_llm_calls_totalprovider, statusLLM calls by provider

Connector Metrics

MetricLabelsDescription
axonflow_connector_calls_totalconnectorConnector calls
axonflow_connector_duration_milliseconds_bucketconnectorConnector latency
axonflow_connector_errors_totalconnector, error_typeConnector errors

Customization

Adding Custom Panels

  1. Open the dashboard in Grafana
  2. Click Add → Visualization
  3. Configure your query using available Prometheus metrics
  4. Save the dashboard

Exporting Changes

To persist dashboard changes to source control:

  1. Click Dashboard settings (gear icon)
  2. Click JSON Model
  3. Copy the JSON
  4. Update config/grafana/dashboards/axonflow-community.json

Troubleshooting

Dashboard Not Loading

# Check Grafana is running
docker compose ps grafana

# Check Grafana logs
docker compose logs grafana

# Verify provisioning files exist
ls -la config/grafana/provisioning/

No Data Showing

# Check Prometheus is scraping targets
open http://localhost:9090/targets

# Verify Agent is exposing metrics
curl http://localhost:8080/metrics

# Query Prometheus directly
curl http://localhost:9090/api/v1/query?query=axonflow_agent_requests_total

Dashboard Shows "No Data"

  1. Ensure you've made some API requests to generate metrics
  2. Check the time range selector (default: Last 1 hour)
  3. Verify the Prometheus datasource is configured correctly in Grafana

Next Steps


Enterprise Dashboard

Enterprise deployments include additional dashboards with Executive Summary views, Cost Analytics, and Compliance reporting. Contact sales for details.