Loading

Kibana connectors

Important

These Kibana connectors are used to connect to external services for GenAI, alerting, and case management use cases.

To learn about connectors for syncing data to Elasticsearch for search use cases, refer to content connectors.

Connectors provide a central place to store connection information for services and integrations with Elastic or third-party systems.

If you're using connectors for alerting or case management, you can create rules and add actions that use connectors to send notifications when conditions are met.

Kibana provides connectors for LLM providers, Elastic Stack features, and third-party alerting and case management platforms.

Access to connectors is granted based on your privileges to alerting-enabled features. For more information, go to Security.

Kibana provides the following connectors, grouped by category.

Note

Some connector types are paid commercial features, while others are free. For a comparison of the Elastic subscription levels, go to the subscription page.

In Stack Management > Connectors, you can find a list of the connectors in the current space. You can use the search bar to find specific connectors by name and type. The Type dropdown also enables you to filter to a subset of connector types.

Filtering the connector list by types of connectors

You can delete individual connectors using the trash icon. Alternatively, select multiple connectors and delete them in bulk using the Delete button.

Deleting connectors individually or in bulk
Note

You can delete a connector even if there are still actions referencing it. When this happens the action will fail to run and errors appear in the Kibana logs.

New connectors can be created with the Create connector button, which guides you to select the type of connector and configure its properties.

Connector select type

After you create a connector, it is available for use any time you set up an action in the current space.

For out-of-the-box and standardized connectors, refer to preconfigured connectors.

Tip

You can also manage connectors as resources with the Elasticstack provider for Terraform. For more details, refer to the elasticstack_kibana_action_connector resource.

When you create a connector, you set a Connector name (the display name in Kibana) and a Connector ID (the stable identifier used by APIs and integrations). Kibana suggests a connector ID by slugifying the connector name. It produces a value that uses only lowercase letters, numbers, and hyphens, then truncates it to at most 36 characters if needed. Spaces and most other characters become hyphens. You can edit that suggestion before you save.

The Connector ID must be unique among connectors available in the current Kibana space, including preconfigured connectors. After you save the connector, the connector ID cannot be changed. To use a different ID, create a new connector with the same type and configuration, choose the new ID, then update rules and other integrations to reference that connector.

To create a connector with the API, use Create a connector. Send POST /api/actions/connector (or POST /s/<space_id>/api/actions/connector outside the default space) to let Kibana generate an ID, or include the desired ID in the path: POST /api/actions/connector/<connector_id>. Custom IDs must follow the same rules as in the UI. They can only be 1–36 characters, and must use lowercase letters, numbers, and hyphens only.

Rules use connectors to route actions to different destinations like log files, ticketing systems, and messaging tools. While each Kibana app can offer their own types of rules, they typically share connectors. Stack Management > Connectors offers a central place to view and manage all the connectors in the current space.

Example connector listing in the Rules UI

If you are running Kibana on-prem, you can preconfigure a connector to have all the information it needs prior to startup by adding it to the kibana.yml file. Refer to preconfigured connectors for more information.

Use the action configuration settings to customize connector networking configurations, such as proxies, certificates, or TLS settings. You can set configurations that apply to all your connectors or use xpack.actions.customHostSettings to set per-host configurations.

To import and export connectors, use the Saved Objects Management UI.

If you import a connector and use Check for existing objects, and its connector ID matches a preconfigured connector, Kibana warns you that the preconfigured connector takes precedence and removes the imported connector. If you import with Create new objects with random IDs, Kibana keeps both objects and assigns a new id to the imported connector.

Connectors import banner

If a connector is missing sensitive information after the import, a Fix button appears in Connectors.

Connectors with missing secrets

Important

When cloud deployment or project metadata is available, outbound connector HTTP requests include a deployment or project identifier in the User-Agent header. When that metadata is not available, connector requests do not add this fragment. The User-Agent stays at the default HTTP client value (for example, axios/1.7.2).

IT and information security teams can match outbound connector traffic in third-party audit or access logs to the originating deployment or project—for example, during incident response or when a vendor contacts Elastic about suspicious activity.

For every outbound HTTP request made by a connector (for example, to Slack, Google Workspace, or PagerDuty), Kibana sets a User-Agent header that includes an identifier for the deployment or project that originated the traffic. This is automatic and does not require connector configuration, networking settings, or other administrator actions.

The header starts with the underlying HTTP client name and version (for example, axios/1.7.2). When cloud metadata is available, an additional Elastic fragment is appended.

Environment Example suffix in User-Agent Meaning
Elastic Cloud Hosted elastic (deployment:<deployment_id>) <deployment_id> is the deployment ID.
Elastic Cloud Serverless elastic (project:<project_id>) <project_id> is the serverless project ID.

Elastic Cloud organization administrators can look up deployment and Elastic Cloud Serverless project identifiers across their organization. Users with other roles can look them up only for deployments and projects they have access to.

Kibana does not provide a UI or API to resolve the deployment or project values shown in connector User-Agent headers. Use the following steps instead:

  1. Copy the identifier from the header. The identifier is the substring after deployment: or project:.
  2. Open the Elastic Cloud console and sign in.
  3. Go to the Hosted (for Elastic Cloud Hosted deployments) or Serverless (for Serverless projects) page, and enter the ID in the search field to find the matching deployment or project.

The Task Manager health API helps you understand the performance of all tasks in your environment. However, if connectors fail to run, they will report as successful to Task Manager. The failure stats will not accurately depict the performance of connectors.

For more information on connector successes and failures, refer to the Event log index.