Map Konnect Analytics reports in Service Catalog

Uses: Service Catalog

Deployment Platform:

Prerequisites

Kong Konnect

If you don’t have a Konnect account, you can get started quickly with our onboarding wizard.

The following Konnect items are required to complete this tutorial:
- Personal access token (PAT): Create a new personal access token by opening the Konnect PAT page and selecting Generate Token.
Set the personal access token as an environment variable:
```
export KONNECT_TOKEN='YOUR KONNECT TOKEN'
```

Konnect Analytics reports

You’ll need a Konnect Analytics report to ingest in Service Catalog as resources.

Create a service in Service Catalog

In this tutorial, you’ll map Reports from Konnect Analytics to a service in Service Catalog. Because the Konnect Analytics integration is built-in, you don’t need to install or authorize it like other Service Catalog integrations.

Create a service that you’ll map to your Konnect Analytics resources:

 curl -X POST "https://us.api.konghq.com/v1/catalog-services" \
     -H "Authorization: Bearer $KONNECT_TOKEN" \
     --json '{
       "name": "billing",
       "display_name": "Billing Service"
     }'

Export the Service Catalog service ID:

export SERVICE_ID='YOUR-SERVICE-ID'

List Konnect Analytics resources

Before you can map a resource to Service Catalog, you first need to find the resources that are pulled in from Konnect Analytics:

 curl -X GET "https://us.api.konghq.com/v1/resources?filter%5Bintegration.name%5D=analytics" \
     -H "Authorization: Bearer $KONNECT_TOKEN"

Export the resource ID you want to map to the service:

export ANALYTICS_RESOURCE_ID='YOUR-RESOURCE-ID'

Map resources to a Service Catalog service

Now, you can map the Konnect Analytics resource to the service:

 curl -X POST "https://us.api.konghq.com/v1/resource-mappings" \
     -H "Authorization: Bearer $KONNECT_TOKEN" \
     --json '{
       "service": "'$SERVICE_ID'",
       "resource": "'$ANALYTICS_RESOURCE_ID'"
     }'

Validate the mapping

To confirm that the Konnect Analytics resource is now mapped to the intended service, list the service’s mapped resources:

 curl -X GET "https://global.api.konghq.com/v1/catalog-services/$SERVICE_ID/resources" \
     -H "Authorization: Bearer $KONNECT_TOKEN"