---
title: TracingDecorator
description: PingGateway can push traces to an OpenTelemetry service. You set up OpenTelemetry tracing in the AdminHttpApplication (admin.json) configuration.
component: pinggateway
version: 2026
page_id: pinggateway:reference:TracingDecorator
canonical_url: https://docs.pingidentity.com/pinggateway/2026/reference/TracingDecorator.html
revdate: 2025-06-02T18:01:47Z
section_ids:
  TracingDecorator-usage-decorator: Decorator Usage
  TracingDecorator-usage-object: Decorated Object Usage
  more_information: More information
---

# TracingDecorator

PingGateway can push traces to an [OpenTelemetry](https://opentelemetry.io/) service. You set up OpenTelemetry tracing in the [AdminHttpApplication (`admin.json`)](AdminHttpApplication.html) configuration.

|   |                                                                                                                                                                                                                              |
| - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   | This feature has [Evolving](https://docs.pingidentity.com/pinggateway/release-notes/stability.html#interface-stability) interface stability. It is subject to change without notice, even in a minor or maintenance release. |

The span content of traces, such as attached metadata like request details, aren't supported. Compatibility isn't guaranteed.

## Decorator Usage

```json
{
    "name": string,
    "type": "TracingDecorator"
}
```

A TracingDecorator doesn't have configurable properties.

PingGateway creates a default TracingDecorator named `tracing` at startup time in the top-level heap. You can use the `tracing` decorator without additional configuration.

## Decorated Object Usage

```json
{
    "name": string,
    "type": string,
    "<decorator-name>": configuration expression<boolean>
}
```

* `"name"`: *[string](preface.html#definition-string), required except for inline objects*

  The unique name of the object, just like an object that isn't decorated.

* `"type"`: *<[string](preface.html#definition-string)>, required*

  The class name of the decorated object.

* \<decorator-name>: configuration expression<[boolean](preface.html#definition-boolean)>, required

  * `true`: Activate tracing

  * `false`: Deactivate tracing

## More information

[org.forgerock.openig.decoration.tracing.TracingDecorator](../_attachments/apidocs/org/forgerock/openig/decoration/tracing/TracingDecorator.html)