Konnect Search reference

Uses: Konnect Platform

Related Documentation

Incompatible with

on-prem

Related Resources

Konnect Search allows to search across all Konnect entities within an organization using simple keywords as well as precise query syntax.. You can access search using the search bar (Command+K or Control+K) at the top of every page in Konnect or using the Konnect Search API.

The Konnect Search, by default, searches for both global and regional entities (with regional-awareness for the currently selected region). This ensures that returned entities are relevant to their geographical location. By default, every search performs:

A global resources fetch for global Konnect entities, such as users, teams, and networks
A geo-scoped fetch, searching through entities in the current Konnect geo. For example, if you’ve selected the US geo, Konnect search will only search for entities in the US geo.

Konnect allows you to perform basic search (simple keyword match) as well as advanced search (query syntax). To perform a basic search, click the Basic tab. You can search for a known entity, like a Service, API, or team, using basic search. You can also perform an advanced search by clicking the Advanced tab and using Konnect’s query syntax to get more precise results or results that match a specified criteria.

Here are a few example use cases where you can use the Konnect Search capabilities:

You want to…	Then use…
Navigate to a specific entity that you know exists	Click the Basic tab and search for the name, ID, description, or keywords of the entity in the Konnect search bar to quickly navigate to the entity page in Konnect.
Find entities that match specific criteria	Click the Advanced search tab and specify your search criteria using query syntax.

Query syntax

Konnect Search provides selectors, reserved characters, and logical operators that you can use to narrow your entity search. By combining these selectors, reserved characters, and logical operators, you can construct complex and precise queries to effectively use Konnect Search.

Perform an advanced search with query syntax by clicking the Advanced tab. The following is an example advanced search query syntax:

type:team AND NOT label.department:eng AND name:*_qa

Copied!

In this example, the query syntax is made up of the following components:

Selectors: type, label, and name. They define what you are searching by.
Entity type: team. These define what Konnect entity you want to search for.
Logical operator: AND NOT and AND. These are used to combine multiple criteria in a query.
Wildcard: * to denote any a suffix match.
Search values: eng and _qa. These are the values that the search service is matching for.

Entity types

The following Konnect entity types are supported:

api
api_product
api_product_version
application
catalog_service
ca_certificate
certificate
consumer
consumer_group
control_plane
dashboard
data_plane
developer
developer_team
key
key_set
mesh
mesh_control_plane
plugin
portal
report
route
service
sni
system_account
target
team
upstream
user
vault
zone

Additional entities may be added in future releases. You can view a list of all the supported entities by sending the following API request:

curl -X GET "https://global.api.konghq.com/v1/search/types" \
     --no-progress-meter --fail-with-body  \
     -H "Accept: application/json"\
     -H "Authorization: Bearer $KONNECT_TOKEN"

Copied!

Searchable attributes

For each entity type, there is a list of entity specific attributes that are searchable. These attributes are returned in the attributes object in the search response, while the schema of the searchable attributes can be found in the /types endpoint.

Selectors

Selectors are used to define the criteria of the search. The following table describes the different selectors and their functions:

Selector	Function	Example
`type:{entity_type}`	Searches for a specific entity type.	`type:control_plane`
`{value}`	Searches for a match in `{value}` on any all searchable attributes.	`foobar`
`id:{value}`	Searches for a match on `id`.	`id:df968c45-3f20-4b80-8980-e223b250dec5`
`name:{value}`	Searches for a match on `name`.	`name:default`
`description:{value}`	Searches for a match on `description`.	`description:temporary`
`labels.{label_key}:{label_value}`	Searches for an exact match for a labeled entity.	`labels.env:prod`
`@public_labels.{label_key}:{label_value}`	Searches for an exact match for a labeled entity in Dev Portal.	`@public_labels.env:prod`
`@{attribute_key}:{attribute_value}`	Searches for an exact match for an entity specific attribute.	`@email:"admin@domain.com"`

Reserved characters

The following table describes the characters with special meanings in the query syntax:

Character	Function
`*`	Use as a wildcard.
`""`	Denotes an exact match. This is case insensitive and includes spaces.

Logical operators

Logical operators are used to combine multiple criteria in a search query. Operators are case-sensitive.

The following table describes each operator and how it functions in the query syntax:

Operator	Function
`AND`	Searches for entities that are in all of the listed fields.
`OR`	Searches for entities that are in one or more of the listed fields.
`NOT`	Searches for entities that are not in a field.

Example search queries

The following table describes different example search queries:

Search type	Query	Description
Simple	`Dana`	This query searches for entities with a searchable attribute containing the value `Dana`.
Simple	`name:Dana`	This query searches for entities with the name `Dana`.
Simple	`name:"Dana H"`	This query searches for entities with the name `"Dana H"`. The quotes around `"Dana H"` indicate an exact match, including spaces.
Logical	`type:team AND name:*_qa`	This query finds teams in the QA department. It combines multiple selectors: `type:team` limits the search to the `teams` entity type and `name:*_qa` filters for teams that have a `_qa` suffix.
Logical	`name:dev OR name:qa OR name:*test`	This query finds any entities that contain `dev` or `qa` or `test` in its name. It combines multiple `name:` selectors to limit the results to entities that match one of these terms.
Exclusion	`type:system_account AND NOT temp`	This query finds system accounts that don’t contain `temp` in their name and description. The `NOT` logical operator is used to exclude entities.
Exclusion	`type:team AND NOT name:team-blue AND NOT description:blue`	This query finds teams that are not named `team-blue` and don’t contain `blue` in its description. The `NOT` logical operator is used to exclude entities.
Wildcards	`name:Project*`	This query uses a wildcard to find entities starting with the prefix `Project`. The `*` serves as a wildcard.
Wildcards	`description:*_prod`	This query uses a wildcard to find entities ending with the description `_prod`. The `*` serves as a wildcard.