How to Create Collector Integration for API Observability

Last updated: August 18, 2025

Overview

This guide explains how to create integrations for Astra Traffic Collector (collector).

Prerequisites

  • Access to the API Security Platform

  • Appropriate user permissions to create integrations

Step 1: Navigate to Traffic Connectors

  1. Log in to the Astra Dashboard.

  2. From the main navigation menu, select:
    API Security → Traffic Connectors

  3. Chose the right workspace under which Integration needs to be created

    image.png

Step 2: Create Collector Integration

The Astra Traffic Collector is responsible for receiving and processing telemetry data from your APIs.

  1. Locate the Astra Traffic Collector row in the integrations list.

  2. Click the Connect button next to it.

    image.png

  3. Follow the on-screen prompts to complete the setup wizard.

  4. At the final step, you will be shown the following credentials:

    • Client ID

    • Client Secret

    Important Notes:

    • These credentials are similar to Personal Access Tokens (PAT) and will only be displayed once.

    • Store them securely; if lost, you will need to regenerate them.

    • Regenerating credentials will invalidate the old ones, and the Traffic Collector configuration must be updated with the new credentials.

    image.png

  5. After successful creation, the collector should now appear under the Active Integrations section.

Regenerating Credentials for Astra Traffic Collector

If you lose your Client Secret or need to rotate credentials for security compliance, you can regenerate them.

  1. Navigate to Active Integrations in the Traffic Connectors section.

  2. Locate the specific Astra Traffic Collector integration instance.

  3. Click the three-dot menu (⋮) next to it and select Regenerate Client Secret.

    image.png

  4. The portal will display:

    • Collector ID

    • Client ID

    • Client Secret

    image.png

  5. Update your Traffic Collector configuration to use these new credentials immediately.

  6. Remember: the old credentials will no longer work once regeneration is complete.

Best Practices

  • Store all integration credentials in a secure secrets manager.

  • Rotate credentials periodically for security compliance.

  • Verify integrations by sending test API traffic and checking the collector logs.