このページは、まだ日本語ではご利用いただけません。翻訳中です。
The Konnect Service Catalog
Track every service across your architecture
この機能はbetaとしてリリースされており、本番環境では依存すべきではありません。
Kong Konnect’s Service Catalog offers a comprehensive catalog of all services running in your organization. By integrating with both Konnect-internal applications, like Gateway Manager and Mesh Manager, as well as external applications like GitHub and PagerDuty, Service Catalog provides you with a 360 overview into each of your organization’s services. It presents you with information that include who the service’s owner is, its upstream and downstream dependencies, its code repositories, its CI/CD pipelines, and whether it is fronted by an API gateway or is part of a service mesh.
graph LR %% Define styles for icons and nodes classDef konnect stroke-dasharray:3,rx:10,ry:10 classDef serviceCatalog fill:#d0e5f3,rx:10,ry:10 %% Define the resources ExternalIntegration1(External Integration 1):::resource ExternalIntegration2(External Integration 2</div>):::resource GatewayManager(Gateway Manager):::resource %% Define the Konnect Service Catalog and its subgraphs subgraph KonnectServiceCatalog[Konnect Service Catalog] direction TB %% Define the Billing Service subgraph inside Konnect Service Catalog subgraph BillingService[Billing Service] direction LR KongGatewayService(Gateway service 1) ExternalResourceMapping1(External resource) ExternalResourceMapping2(External resource) end %% Define the Inventory Service Catalog Service subgraph inside Konnect Service Catalog subgraph InventoryService[Inventory Service] direction LR SomeOtherService(Gateway service 2) AnotherService(External resource) DifferentRepo(External resource) end end %% Connect the resources to the Konnect Service Catalog ExternalIntegration1 -- "External resource" --> KonnectServiceCatalog ExternalIntegration2 -- "External resource" --> KonnectServiceCatalog GatewayManager -- "Gateway services" --> KonnectServiceCatalog %% Style the subgraphs class KonnectServiceCatalog konnect class BillingService serviceCatalog class InventoryService serviceCatalog
Figure 1: This diagram shows how you can use both external integrations, like GitHub and PagerDuty, as well as internal integrations like Gateway Manager to pull resources into Service Catalog. You can then map those resources (like GitHub repositories, PagerDuty services, and Gateway services) to Service Catalog services.
Service Catalog use cases
You want to… | Then use… |
---|---|
Keep track of your organization’s resource ownership by mapping teams to Service Catalog services. | Add the Service Catalogservice’s owner when you create a new Service Catalog service in Konnect |
Gain visibility into all your services, including unrecognized or undiscovered APIs in your organization. | Service Catalog integrations |
Consolidate key Service Catalog service health metrics, documentation, and API specs into a single list, allowing you to interact with other tools from one place. | Service Catalog dashboard |
Service Catalog terminology
Term | Definition |
---|---|
Integration | These are applications, either Konnect-internal or external, that act as sources from which you can ingest resources. For example, GitHub. |
Resource | An umbrella term that denotes entities ingested by Service Catalog from enabled integrations. A resource can range from an infrastructural component (like Gateway services, mesh services, databases, and caches) to an external application or tool (like code repositories, CI/CD infrastructure, and on-call systems) to a piece of documentation (like API specs). Resources can be mapped to one or more Service Catalog services. |
Service Catalog service | A unit of software that is typically owned by a single team, exposes one or more APIs, and may be dependent on other Service Catalog services (as either upstream or downstream). A Service Catalog service can be thought of as a collection of one or more resources. |
Service Catalog | A comprehensive catalog of all resources and Service Catalog services running in your organization. |
Events | An event is a captured unit of information logged by the Service Catalog. It includes a wide range of activities such as user-driven actions, configuration changes, and alerts. |
FAQs
How do Service Catalog services map to API products? What is the relationship there?
Service Catalog services do not directly map to API products. Rather, a Gateway service can be linked to a Service Catalog service and you can then map the Gateway service to an API product version in Service Catalog.
How do I view the health and status of my services in the Service Catalog?
Navigate to Services in the Service Catalog and click on the Service Catalog service you want to view the health and status of.
How can I identify which resources are available for mapping to my Service Catalog services?
Navigate to the Resources page in the Service Catalog to view a list of all available resources. These are ingested by Service Catalog from the integrations that have been installed and authorized, which are found on the Integrations page.
What should I do if I notice discrepancies in the data shown in the Service Catalog?
Check the Service Catalog integration settings and data sources for any issues. Ensure that all connected tools are properly configured and that data synchronization is functioning correctly.
Can I control who has access to specific Service Catalog service or data?
Yes, you can configure access controls and manage permissions to Service Catalog by configuring teams and roles.