> ## Documentation Index
> Fetch the complete documentation index at: https://docs.halios.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Invocations

> Monitor real-time API calls and guardrail triggers

## Overview

The Invocations page provides a comprehensive view of all API requests processed through your guardrails, including detailed information about each request, response status, and any guardrail violations that occurred.

## Key Features

### Request Monitoring

* **Real-time Tracking**: View all API requests as they happen
* **Request Details**: See full request/response data including headers, body, and metadata
* **Status Monitoring**: Track request success rates and error conditions

### Filtering & Search

* **Request ID Search**: Find specific requests by their unique identifier
* **Date Range Filtering**: Filter requests by date and time ranges
* **Content Hash Search**: Search by content hash for duplicate detection
* **Agent Filtering**: Filter by specific AI agents
* **Status Filtering**: Filter by response status (success/error/blocked)

### Violation Tracking

* **Guardrail Triggers**: See which guardrails were triggered for each request
* **Violation Details**: View specific violations and their severity levels
* **Response Actions**: Track what actions were taken (block/filter/audit)

## Use Cases

* **Performance Monitoring**: Track API response times and identify bottlenecks
* **Security Auditing**: Monitor for suspicious patterns and security violations
* **Compliance Reporting**: Generate reports for regulatory compliance requirements
* **Troubleshooting**: Debug issues with specific requests or guardrail configurations

## Best Practices

* Regularly review violation patterns to identify potential security issues
* Use filters to focus on specific time periods or request types
* Monitor performance metrics to ensure optimal system operation
* Export data for detailed analysis and reporting
