Guardrailz
HomeHubBlogsPricingDocs

Introduction

  • Overview
  • Architecture
  • Core Concepts

Getting Started

  • Installation
  • Quickstart
  • Playground

API

  • Validate API
  • Profiles API
  • Analytics API
  • Error Handling

SDK

  • Overview
  • Client
  • Guardrails
  • Examples

Guardrails

  • Overview
  • Input Guardrails
  • Output Guardrails
  • Tool Guardrails
  • Custom Guardrails

Profiles

  • Overview
  • Built-in Profiles
  • Custom Profiles
  • Profile Compilation

Analytics

  • Overview
  • Events
  • Queries
  • Dashboards

Deployment

  • Environment
  • Security
  • Scaling
  1. Docs
  2. /api
  3. /analytics

Analytics API

The Analytics API provides visibility into guardrail execution, performance, and failures.

It enables monitoring, auditing, and optimization of AI safety systems.

Overview Metrics

 
GET /api/analytics?range=7d

Response

{
  "overview": {
    "totalExecutions": 12450,
    "successRate": 97.4,
    "avgExecutionTime": 38
  }
}

Supported Ranges

  • 24h
  • 7d
  • 30d
  • 90d

Guardrail Performance

Metrics include:

  • Execution count per guardrail
  • Failure rate
  • Average latency
  • Most frequent violations

Use Cases

  • Detect prompt injection attempts
  • Identify slow or noisy guardrails
  • Monitor compliance trends
  • Audit user behavior

Data Model

Each analytics event includes:

  • User ID
  • API key (optional)
  • Profile ID
  • Guardrail results
  • Execution metadata

Notes

  • Analytics data is append-only
  • Designed for high-volume workloads
  • Safe for regulated environments