End of Sale Notice:

F5 NGINX is announcing the End of Sale (EoS) for NGINX Management Suite API Connectivity Manager Module, effective January 1, 2024.

F5 maintains generous lifecycle policies that allow customers to continue support and receive product updates. Existing API Connectivity Manager Module customers can continue to use the product past the EoS date. License renewals are not available after September 30, 2024.

See our End of Sale announcement for more details.

Request Correlation ID

Learn how to use API Connectivity Manager’s Request Correlation ID policy to add a unique identifier to each request entering your app, which you can use to trace end-to-end transactions in a distributed system.

Overview

In API Connectivity Manager, you can apply global policies to API Gateways and Developer Portals to ensure your organization’s security requirements are enforced.

When you add policies at the environment level, they will apply to all proxies hosted within that environment.

See the Learn about Policies topic for an overview of the different policy types and available policies.


About the Policy

Use the Request Correlation ID policy to add a unique identifier to each request that enters an application. With the Correlation ID policy, you can trace end-to-end transactions moving through components in a distributed system. This policy is applied by default and usually uses x-correlation-id as the default HTTP header name. However, you can also provide a custom header value if needed.

Intended Audience

This guide is meant for Infrastructure Administrators.

Infrastructure Administrators ensure uniform governance across an organization’s infrastructure by setting policies at the infrastructure level, enabling teams to build APIs without interruption while adhering to the organization’s standards.


Workflow for Applying Policy

To apply the policy or make changes to it, here’s what you need to do:


Policy Settings

Field Type Possible Values Description Required Default Value
httpHeaderName string Example:
x-correlation-id
The HTTP header name to use when passing the correlation ID. YES x-correlation-id

Applying the Policy

You can apply this policy using either the web interface or the REST API. The policy uses x-correlation-id as the default HTTP header name, or you can provide a custom header value.


To create a Request Correlation ID policy using the REST API, send an HTTP POST request to the Environment endpoint.

Method Endpoint
POST /infrastructure/workspaces/{workspace}/environments/{environment}
JSON request
{
  "policies": {
    "request-correlation-id": [
      {
        "action": {
          "httpHeaderName": "x-correlation-id"
        }
      }
    ]
  }
}

This JSON example defines a Request Correlation ID policy, which specifies that an HTTP header called x-correlation-id should be used when passing the correlation ID.

To add a Request Correlation ID policy using the web interface:

  1. In a web browser, go to the FQDN for your F5 NGINX Management Suite host and log in. Then, from the Launchpad menu, select API Connectivity Manager.

  2. On the left menu, select Infrastructure.

  3. Choose the workspace that includes the environment for the cluster you want to add the policy to.

  4. Select the environment for your cluster.

  5. In the list of clusters, locate the cluster you want to add the policy to. On the Actions menu (represented by an ellipsis, ...), select Edit Advanced Config.

  6. On the left menu, select Global Policies.

  7. From the list of policies, locate the Request Correlation ID policy, then select Add Policy from the Actions menu (represented by an ellipsis, ...).

  8. On the Request Correlation ID form, complete the necessary fields:

    • HTTP Header Name: The HTTP header name to use when passing the correlation ID. The default is x-corrrelation-id.
  9. Select Add to apply the policy to the cluster.

  10. Select Save and Submit to deploy the configuration.