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

# Metrics

> Comprehensive operational metrics tracked automatically for compliance, performance monitoring, and business insights.

Every Fiskil instance automatically captures a comprehensive set of operational metrics covering performance, availability, traffic patterns, and authorization activity. These metrics are essential for compliance with consumer data standards and provide valuable insights for monitoring and capacity planning.

<Note>
  Metrics are collected continuously and used for compliance reporting. Console visibility and export capabilities are coming soon.
</Note>

***

## Performance & Availability Metrics

<CardGroup cols={2}>
  <Card title="Availability Monitoring" icon="chart-line">
    Track instance uptime and service availability over time periods to ensure SLA compliance.
  </Card>

  <Card title="Performance Tracking" icon="gauge-high">
    Monitor API response times and success rates against defined performance thresholds.
  </Card>
</CardGroup>

| Metric                    | Description                                                      | Use Case                                                |
| ------------------------- | ---------------------------------------------------------------- | ------------------------------------------------------- |
| **Availability**          | Percentage of time your instance is available to serve requests  | SLA monitoring and compliance reporting                 |
| **Performance**           | Percentage of API calls completing within performance thresholds | Identify performance degradation and optimization needs |
| **Average Response Time** | Mean response time from your Resource Server in milliseconds     | Performance tuning and capacity planning                |

***

## Traffic & Usage Metrics

Understanding traffic patterns and usage helps with capacity planning and identifying trends in data sharing adoption.

| Metric            | Description                                                   | Key Insights                               |
| ----------------- | ------------------------------------------------------------- | ------------------------------------------ |
| **Invocations**   | Total number of API calls received, segmented by time periods | Traffic volume and usage patterns          |
| **Average TPS**   | Average transactions per second over time                     | Steady-state load characteristics          |
| **Peak TPS**      | Maximum observed transactions per second                      | Peak capacity requirements                 |
| **Session Count** | Number of active sessions (access token provisioning events)  | User engagement and authorization activity |

***

## Authorization & Compliance Metrics

<Tabs>
  <Tab title="User Activity">
    Track customer and recipient engagement with your data sharing platform.

    | Metric                   | Description                                                 |
    | ------------------------ | ----------------------------------------------------------- |
    | **Customer Count**       | Number of customers with active authorizations              |
    | **Data Recipient Count** | Number of recipient applications with active authorizations |
    | **Authorizations**       | Total authorizations processed over time                    |
  </Tab>

  <Tab title="Error Tracking">
    Monitor error rates and rejected requests for operational health.

    | Metric         | Description                                    |
    | -------------- | ---------------------------------------------- |
    | **Errors**     | API calls resulting in error responses         |
    | **Rejections** | Calls rejected due to traffic threshold limits |
  </Tab>

  <Tab title="Secondary Holders">
    For shared-responsibility deployments with secondary data holders.

    | Metric                          | Description                                 |
    | ------------------------------- | ------------------------------------------- |
    | **Secondary Holder Errors**     | Errors received from secondary data holders |
    | **Secondary Holder Rejections** | Rejections from secondary data holders      |
  </Tab>
</Tabs>

***

## How Metrics Support Your Operations

<AccordionGroup>
  <Accordion title="Compliance & Regulatory Reporting">
    Metrics are automatically tracked in accordance with consumer data standards (CDR, FDX, etc.), ensuring you meet regulatory requirements without manual effort.
  </Accordion>

  <Accordion title="Performance Optimization">
    Monitor response times, throughput, and error rates to identify optimization opportunities and ensure your Resource Server meets performance targets.
  </Accordion>

  <Accordion title="Capacity Planning">
    Use traffic patterns, peak TPS, and session counts to plan infrastructure scaling and anticipate future capacity needs.
  </Accordion>

  <Accordion title="Audit Readiness">
    Maintain verifiable records of availability, authorization activity, and performance metrics for compliance audits and regulatory reviews.
  </Accordion>
</AccordionGroup>

***

## Current Availability

<CardGroup cols={3}>
  <Card title="Automatic Collection" icon="check-circle">
    All metrics are tracked continuously by Fiskil without any configuration required.
  </Card>

  <Card title="Compliance Ready" icon="shield-check">
    Metrics collection meets consumer data standard requirements for operational monitoring.
  </Card>

  <Card title="Coming Soon" icon="clock">
    Console visibility and external system export capabilities are in development.
  </Card>
</CardGroup>

<Info>
  We'll announce when metrics become available for viewing in the Console or export to external monitoring systems.
</Info>

***

## Related Documentation

<CardGroup cols={3}>
  <Card title="Request Logs" href="/docs/telemetry/logs" icon="file-text">
    View detailed request-level logs and configure log drains to external systems.
  </Card>

  <Card title="Go Live Checklist" href="/docs/go-live" icon="list-check">
    Ensure your instance is ready for production with our comprehensive checklist.
  </Card>

  <Card title="Security & Compliance" href="/docs/security" icon="lock">
    Learn about Fiskil's security measures and compliance certifications.
  </Card>
</CardGroup>
