Back to Skills

kibana-streams

List, inspect, enable, disable, and resync Kibana Streams via the REST API. Use when the user needs stream details, ingest/query settings, queries, significant events, or attachments.

531stars41forksUpdated 7/11/2026

Security Assessment

Safe(100/100)
Security Score100/100

About kibana-streams

Kibana Streams are an experimental way to manage data in Kibana, and this skill drives their REST API for read and lifecycle work without touching mutating operations like create, update, delete, or fork. It reads stream metadata and definitions, ingest and query settings, the queries attached to a stream, significant events, and attachments such as linked dashboards, rules, and SLOs. On the lifecycle side it can enable, disable, and resync streams through the dedicated POST endpoints. Requests go to <kibana_url>/api/streams, or the space-scoped /s/{space_id}/api/streams path when working outside the default space, and authenticate with an API key or basic auth. Read operations need the read_stream privilege while lifecycle calls need manage_stream; mutating lifecycle endpoints also require the kbn-xsrf: true header. A dedicated focus is retention: ingest settings expose both a stream lifecycle (ingest.lifecycle, using lifecycle.dsl.data_retention such as 30d, or lifecycle.inherit for child streams) and a separate failure store lifecycle that governs only failed documents. When someone asks to set or change retention, the skill targets the stream's main data retention rather than the failure store unless failed documents are explicitly mentioned. Because the API and its behavior are still experimental, callers should expect changes over time and consult the official Streams API operation pages for exact request and response bodies. Safety guidance is built in around the disable operation: disabling wired streams deletes their data (classic stream data is preserved), so the skill warns and asks for confirmation before proceeding. It favors read operations when the user only needs to inspect stream state, reserving lifecycle APIs for cases that genuinely require enabling, disabling, or resyncing. Endpoint and parameter detail lives in the bundled streams API reference.

FAQ

What operations does this skill cover?

Read operations (listing streams, getting a single stream, ingest and query settings, queries, significant events, and attachments) and lifecycle operations (enable, disable, resync). Create, update, delete, fork, and other mutating operations are not supported.

What privileges do I need?

read_stream for read operations and manage_stream for lifecycle APIs. Mutating lifecycle calls also send the kbn-xsrf: true header.

How do I set or change a stream's retention?

Target the stream's main data retention under ingest settings (ingest.lifecycle, using lifecycle.dsl.data_retention like 30d, or lifecycle.inherit for child streams), not the failure store lifecycle, unless failed documents are explicitly mentioned.

Is disabling a stream safe?

Disabling can cause data loss: the disable API deletes wired stream data (classic stream data is preserved). The skill warns and confirms before proceeding.

How do I operate in a non-default Kibana space?

Use the space-scoped base path /s/{space_id}/api/streams instead of /api/streams, and authenticate with an API key or basic auth.

All Files

2 files
SKILL.md7.2 KB
View
references/streams-api-reference.md5.3 KB
View

Install kibana-streams

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill