› › ›

Get pipeline API

This API retrieves pipelines used for Logstash Central Management.

Request

GET _logstash/pipeline

GET _logstash/pipeline/<pipeline_id>

Prerequisites

If the Elasticsearch security features are enabled, you must have the manage_logstash_pipelines cluster privilege to use this API.

Description

Retrieve one or more Logstash pipelines.

Path parameters

<pipeline_id>: (Optional, string) Comma-separated list of pipeline identifiers.

Examples

The following example retrieves the pipeline named my_pipeline:

GET _logstash/pipeline/my_pipeline

If the request succeeds, the body of the response contains the pipeline definition:

{
  "my_pipeline": {
    "description": "Sample pipeline for illustration purposes",
    "last_modified": "2021-01-02T02:50:51.250Z",
    "pipeline_metadata": {
      "type": "logstash_pipeline",
      "version": "1"
    },
    "username": "elastic",
    "pipeline": "input {}\n filter { grok {} }\n output {}",
    "pipeline_settings": {
      "pipeline.workers": 1,
      "pipeline.batch.size": 125,
      "pipeline.batch.delay": 50,
      "queue.type": "memory",
      "queue.max_bytes": "1gb",
      "queue.checkpoint.writes": 1024
    }
  }
}

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/logstash-api-get-pipeline.html