Stay organized with collections
Save and categorize content based on your preferences.
This page
applies to Apigee and Apigee hybrid.
This page describes how to configure API observations in API hub for Apigee runtime projects.
Before you begin
API observations is part of the Advanced API Security add-on. To ingest the Apigee API Observation assets, you must first activate this add-on by enabling Shadow API Discovery from the Shadow APIs page.
Click settingsSettings from the left navigation menu to open the Settings page.
Go to the Project associations tab and click Attach runtime project. This displays the Select a resource pane.
Click the Google Cloud project where the Apigee instance is installed.
In the Project association settings pane, select the Apigee API Observation checkbox.
Apigee API Observation discovers and imports Shadow APIs using observation jobs. Ensure that you have created observation jobs in Apigee for API hub to ingest this data.
Click Attach.
The Project associations page is updated with the Apigee runtime project and the Associated plugins column is updated with a new Apigee API Observation plugin instance.
Configure API observations in API hub for existing Apigee runtime projects
For existing Apigee runtime projects that are associated with API hub, you can edit the project association settings to ingest data from Apigee API Observation:
In the Google Cloud console, go to the API hub page.
Click settingsSettings from the left navigation menu to open the Settings page.
Go to the Project associations tab to view the list of attached projects.
Click Edit settings for the desired project.
In the Project association settings pane, select the Apigee API Observation checkbox.
Click Save to apply your changes.
The Project associations page is updated with the Apigee runtime project and the Associated plugins column is updated with a new Apigee API Observation plugin instance.
Considerations
The following considerations apply when configuring API observations in API hub:
The refresh rate for the API observations page in API hub is 30 minutes. This might cause a slight delay in the appearance or update of any newly observed APIs in API hub.
API observations in API hub currently only supports Apigee runtime projects.
Custom tags assigned in Apigee runtime projects are not directly transferred or supported within API hub.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-26 UTC."],[],[],null,["# Configure API observations in API hub\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n|\n| **Preview\n| --- API observations in API hub**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\n\nThis page describes how to configure API observations in API hub for Apigee runtime projects.\n\nBefore you begin\n----------------\n\n- API observations is part of the Advanced API Security add-on. To ingest the Apigee API Observation assets, you must first activate this add-on by enabling Shadow API Discovery from the [Shadow APIs](https://console.cloud.google.com/apigee/api-hub) page.\n- Assign the required [IAM roles and permissions](/apigee/docs/apihub/api-observation-overview?#iam-roles-permissions) to your principal account.\n- Ensure that you have [created observation jobs](/apigee/docs/api-observation/shadow-api-discovery#create-observation-jobs) in Apigee for API hub to ingest this data.\n\nConfigure API observations in API hub for new Apigee runtime projects\n---------------------------------------------------------------------\n\n\nTo configure API observations in API hub for Apigee runtime projects, do the following:\n\n1. In the Google Cloud console, go to the **API hub** page.\n\n [Go to API hub](https://console.cloud.google.com/apigee/api-hub)\n2. Click settings **Settings** from the left navigation menu to open the **Settings** page.\n3. Go to the **Project associations** tab and click **Attach runtime project** . This displays the **Select a resource** pane.\n4. Click the Google Cloud project where the Apigee instance is installed.\n5. In the **Project association settings** pane, select the **Apigee API Observation** checkbox.\n\n\n Apigee API Observation discovers and imports Shadow APIs using observation jobs. Ensure that you have [created observation jobs](/apigee/docs/api-observation/shadow-api-discovery#create-observation-jobs) in Apigee for API hub to ingest this data.\n | **Important:** Apigee API Observation is part of the Advanced API Security add-on. To ingest the Apigee API Observation assets, you must first activate this add-on by enabling Shadow API Discovery from the [Shadow APIs](https://console.cloud.google.com/apigee/api-hub) page.\n6. Click **Attach** .\n\n\n The **Project associations** page is updated with the Apigee runtime project and the **Associated plugins** column is updated with a new **Apigee API Observation** plugin instance.\n\nConfigure API observations in API hub for existing Apigee runtime projects\n--------------------------------------------------------------------------\n\n\nFor existing Apigee runtime projects that are associated with API hub, you can edit the project association settings to ingest data from Apigee API Observation:\n\n1. In the Google Cloud console, go to the **API hub** page.\n\n [Go to API hub](https://console.cloud.google.com/apigee/api-hub)\n2. Click settings **Settings** from the left navigation menu to open the **Settings** page.\n3. Go to the **Project associations** tab to view the list of attached projects.\n4. Click **Edit settings** for the desired project.\n5. In the **Project association settings** pane, select the **Apigee API Observation** checkbox.\n6. Click **Save** to apply your changes.\n\n\n The **Project associations** page is updated with the Apigee runtime project and the **Associated plugins** column is updated with a new **Apigee API Observation** plugin instance.\n\nConsiderations\n--------------\n\n\nThe following considerations apply when configuring API observations in API hub:\n\n- The refresh rate for the **API observations** page in API hub is 30 minutes. This might cause a slight delay in the appearance or update of any newly observed APIs in API hub.\n- API observations in API hub currently only supports Apigee runtime projects.\n- Custom tags assigned in Apigee runtime projects are not directly transferred or supported within API hub.\n\nWhat's next\n-----------\n\n- Learn how to [manage API observations in API hub](/apigee/docs/apihub/manage-api-observation)."]]
