> This page is for Itential Platform On-Prem, version 6 (default).
> For other versions, use one of these documentation indexes:
> - 6 (default): https://docs.itential.com/itential-platform/6/llms.txt
> - 2023.2: https://docs.itential.com/itential-platform/2023-2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# OpenTelemetry web server metrics reference

> Reference for the Itential Platform OpenTelemetry web server metrics endpoint, including the metrics it returns, how it is configured, and what it doesn't report.

Platform 6.6.0+

Itential Platform provides the `GET /metrics/webserver` endpoint, which returns metrics about its web server in Prometheus text format. The endpoint requires an authenticated session. Monitoring tools such as Prometheus, Grafana, and Datadog can use the endpoint to track web server health.

This endpoint is separate from the [`/prometheus_metrics` route](/itential-platform/monitor/prometheus-metrics), which reports a different set of Platform metrics. You can use both.

## Metrics

The endpoint reports only on web server health.

| Metric group   | Description                                             | Broken out by                                                           |
| -------------- | ------------------------------------------------------- | ----------------------------------------------------------------------- |
| Request totals | The number of API requests the web server handled.      | HTTP method, status code class (2xx, 3xx, 4xx, or 5xx), and caller type |
| Latency        | Request and response duration, reported as a histogram. | Not applicable                                                          |
| Errors         | The number of requests that returned an error.          | Route and status code, such as 401, 403, 404, or 500                    |
| Payload size   | The size of request and response payloads.              | Not applicable                                                          |

## Metric behavior

* Values are aggregate totals since the process last started. Totals reset to zero when Platform restarts.
* The endpoint reports current values only. It doesn't store history. To view trends over time, use a monitoring tool that records the values at regular intervals.

## Configuration

Web server metrics collection is enabled by default. The following Platform property and environment variable turn it on or off. For all Platform properties, see the [properties and environment variables reference](/itential-platform/configure/environment-variables-properties-reference).

| Property                         | Environment variable                      | Type    | Default |
| -------------------------------- | ----------------------------------------- | ------- | ------- |
| `otel_webserver_metrics_enabled` | `ITENTIAL_OTEL_WEBSERVER_METRICS_ENABLED` | Boolean | `true`  |

## Limitations

Itential doesn't report the following metrics:

* Node.js and V8 runtime internals, such as event loop lag and garbage collection.
* Per-process CPU and memory breakdowns.
* Time in queue.
* Workflow engine and general server CPU and memory metrics. To monitor them, use [exporters](/itential-platform/monitor/exporters).