Skip to content
Kong Logo | Kong Docs Logo
search
  • We're Hiring!
  • Docs
    • Kong Gateway
    • Kong Konnect
    • Kong Mesh
    • Plugin Hub
    • decK
    • Kubernetes Ingress Controller
    • Insomnia
    • Kuma

    • Docs contribution guidelines
  • Plugin Hub
  • Support
  • Community
  • Kong Academy
Get a Demo Start Free Trial
  • Kong Gateway
  • Kong Konnect
  • Kong Mesh
  • Plugin Hub
  • decK
  • Kubernetes Ingress Controller
  • Insomnia
  • Kuma

  • Docs contribution guidelines
    • Overview of Konnect
    • Architecture
    • Network Resiliency and Availability
    • Port and Network Requirements
    • Compatibility
    • Stages of Software Availability
    • Release Notes
      • Control Plane Upgrades FAQ
      • Supported Installation Options
    • Overview
    • Access a Konnect Account
    • Set up a Runtime
    • Configure a Service
    • Implement and Test the Service
      • Publish and Consume Services
      • Register Applications
    • Import Kong Gateway Entities into Konnect
    • Overview
      • Overview
      • Dashboard
      • Manage Runtime Groups with UI
      • Manage Runtime Groups with decK
      • Installation Options
      • Install with Docker
      • Install on Kubernetes
      • Install on Linux
      • Install on AWS
      • Install on Azure
      • Upgrade a Runtime Instance to a New Version
      • Renew Certificates
      • Runtime Parameter Reference
    • Create Consumer Groups
      • Overview
      • Set Up and Use a Vault in Konnect
    • Kong Gateway Configuration in Konnect
    • Plugin Ordering Reference
    • Troubleshoot
    • Overview
    • Manage Service Documentation
      • Overview
      • Configure a Plugin on a Service
      • Configure a Plugin on a Route
    • Overview
    • Access the Dev Portal
    • Sign Up for a Dev Portal Account
      • Manage Developer Access
      • Manage Application Registration Requests
      • Manage Application Connections
      • Auto Approve Dev and App Registrations
      • Azure OIDC
      • Application Overview
      • Enable and Disable App Registration
        • Overview
        • Okta
        • Curity
        • Auth0
      • Create, Edit, and Delete an Application
      • Register an Application with a Service
      • Generate Credentials for an Application
    • Customize Dev Portal
    • Troubleshoot
    • Introduction to Analytics
    • Analyze Services and Routes
    • Reports Use Cases
    • Reports Reference
    • Troubleshoot
      • Manage a Konnect Account or Plan
      • Change to a Different Plan
      • Manage Payment Methods and Invoices
      • Overview
        • Overview
        • Manage Teams
        • Teams Reference
        • Roles Reference
      • Manage Users
      • Manage System Accounts
      • Set up SSO with OIDC
      • Set up SSO with Okta
      • Login Sessions Reference
    • Account and Org Deactivation
    • Troubleshoot
    • Overview
      • API Documentation
      • Identity Integration Guide
      • API Documentation
      • API Documentation
      • Portal RBAC Guide
      • Overview
      • Nodes
      • Data Plane Certificiates
        • Services
        • Routes
        • Consumers
        • Plugins
        • Upstreams
        • Certificates
        • CA Certificates
        • SNIs
        • Targets
        • Vaults
      • API Spec
      • Filtering
    • Labels

github-edit-pageEdit this page

report-issueReport an issue

enterprise-switcher-iconSwitch to OSS

On this page
  • Default runtime group
  • Multiple runtime groups
  • Administration
  • Runtime group dashboard
  • Runtime group configuration
  • References
    • Runtime groups table
    • Runtime instances table
Kong Konnect
  • Home
  • Kong Konnect
  • Runtime Manager
  • Runtime Groups

Runtime Groups

Konnect manages runtime configuration in runtime groups. Each runtime group acts as a separate control plane and can manage runtime configurations independently of any other group. You can find a list of all runtime groups in your organization on the Runtime Manager overview.

  • A runtime group is a collection of API connectivity runtime instances sharing the same configuration and behavior space.

  • A runtime instance is a single data plane node with a single instance of a runtime, such as Kong Gateway. Runtime instances service traffic for the runtime group. All runtime instances in one runtime group must be of the same type. Currently, only Kong Gateway runtime types are supported.

Every organization has one default runtime group.

With an Enterprise subscription, you can configure additional custom runtime groups. Use multiple groups in one Konnect organization to manage runtime instances and their configuration in any groupings you want.

runtime groups

Figure 1: Example runtime group configuration with three runtime groups: the default group, a development group, and a production group. Konnect is the SaaS-managed global management plane that controls all of the groups, while the runtime groups contain self-managed runtime instances.

Default runtime group

The default runtime group is the foundational group in Konnect. Every region in every organization starts with one default group.

This group can’t be deleted, and its status as the default group can’t be changed.

Multiple runtime groups

In addition to the default runtime group, you can also configure custom groups. Splitting runtime instances and configuration into multiple runtime groups provides multiple specialized environments in one account.

Some common use cases for using multiple runtime groups include:

  • Environment separation: Split environments based on their purpose, such as development, staging, and production.
  • Region separation: Dedicate each runtime group to a region or group of regions. Spin up runtime instances in those regions for each runtime group.
  • Team separation: Dedicate each runtime group to a different team and share resources based on team purpose.

Set up and manage runtime groups →

Administration

Access to each runtime group is configurable on a team-by-team basis using entity-specific permissions.

Administer teams →

Runtime group dashboard

For each runtime group, you can view traffic, error rate, and Kong Gateway service analytics for instances in a runtime group. This allows you to see how much of a runtime group is used. You can also select the time frame of analytics that you want to display.

Runtime group dashboard →

Runtime group configuration

For each runtime group, you can spin up runtime instances and configure the following Kong Gateway objects:

  • Gateway services
  • Routes
  • Consumers
  • Consumer Groups
  • Plugins
  • Upstreams
  • Certificates
  • SNIs
  • Vaults

When there are multiple runtime groups, any object configuration only applies to the runtime group that it was created in. Consumers and their authentication mechanisms don’t carry over to other runtime groups.

Kong Gateway configuration in Konnect →

References

Runtime groups table

The following describes the content of the table found on the Runtime Manager overview.

Column Description
Name The name of the runtime group. This group name must be unique in the organization.
ID A unique ID for the group. This ID is automatically generated when a group is created.
Type Types of runtimes that this group contains. Currently, the only supported runtime type is Kong Gateway.

Runtime instances table

The following describes the content of the Runtime Instances table found on the landing page of a runtime group. You can sort the table by the Last Ping column.

Column Description
Host The hostname of the instance.
Type The runtime instance type. Currently, only Kong Gateway is supported.
Last Ping The last time that this instance received a configuration update from the Konnect control plane to proxy a service.
Version The Kong Gateway version that this instance is running.
ID The UUID of the instance.
Thank you for your feedback.
Was this page useful?
  • Kong
    THE CLOUD CONNECTIVITY COMPANY

    Kong powers reliable digital connections across APIs, hybrid and multi-cloud environments.

    • Company
    • Customers
    • Events
    • Investors
    • Careers Hiring!
    • Partners
    • Press
    • Contact
  • Products
    • Kong Konnect
    • Kong Gateway
    • Kong Mesh
    • Get Started
    • Pricing
  • Resources
    • eBooks
    • Webinars
    • Briefs
    • Blog
    • API Gateway
    • Microservices
  • Open Source
    • Install Kong Gateway
    • Kong Community
    • Kubernetes Ingress
    • Kuma
    • Insomnia
  • Solutions
    • Decentralize
    • Secure & Govern
    • Create a Dev Platform
    • API Gateway
    • Kubernetes
    • Service Mesh
Star
  • Terms•Privacy
© Kong Inc. 2023