Stay organized with collectionsSave and categorize content based on your preferences.
This page
applies toApigeeandApigee 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 theShadow APIspage.
ClicksettingsSettingsfrom the left navigation menu to open theSettingspage.
Go to theProject associationstab and clickAttach runtime project. This displays theSelect a resourcepane.
Click the Google Cloud project where the Apigee instance is installed.
In theProject association settingspane, select theApigee API Observationcheckbox.
Apigee API Observation discovers and imports Shadow APIs using observation jobs. Ensure that you havecreated observation jobsin Apigee for API hub to ingest this data.
ClickAttach.
TheProject associationspage is updated with the Apigee runtime project and theAssociated pluginscolumn is updated with a newApigee API Observationplugin 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 theAPI hubpage.
ClicksettingsSettingsfrom the left navigation menu to open theSettingspage.
Go to theProject associationstab to view the list of attached projects.
ClickEdit settingsfor the desired project.
In theProject association settingspane, select theApigee API Observationcheckbox.
ClickSaveto apply your changes.
TheProject associationspage is updated with the Apigee runtime project and theAssociated pluginscolumn is updated with a newApigee API Observationplugin instance.
Considerations
The following considerations apply when configuring API observations in API hub:
The refresh rate for theAPI observationspage 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-09-04 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)."]]
