Logstash

Logstash MCP server

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mashhurs-logstash-mcp-server": {
      "command": "python3",
      "args": [
        "logstash_mcp_server.py"
      ],
      "env": {
        "LOGSTASH_API_BASE": "http://your-logstash-host:9600"
      }
    }
  }
}

You run a Logstash MCP Server to monitor, analyze, and manage your Logstash instances from a unified MCP client. This server provides tools for connectivity checks, health analysis, JVM and pipeline metrics, and pipeline management, all accessible through a local component or via a client that speaks the MCP protocol.

How to use

You connect to the Logstash MCP Server with an MCP client to perform monitoring, health checks, and pipeline analysis. Use the available tools to verify connectivity, inspect node and pipeline statistics, run health assessments, and obtain detailed JVM and flow metrics. Start a local MCP server process, then initiate your MCP client to initialize the session, discover available tools, and invoke them as needed. If you configure the server with a specific Logstash API base URL, your client will communicate with that endpoint to retrieve data. When you’re finished, stop the MCP server to end the session.

How to install

Prerequisites you need before starting: a system with Python 3 and pip available.

pip install -r requirements.txt

Optionally set the Logstash API base URL if you are not connecting to the default local Logstash instance.

export LOGSTASH_API_BASE="http://your-logstash-host:9600"

Start the MCP server. This runs the server process locally and waits for MCP client connections.

python3 logstash_mcp_server.py

Configuration and usage notes

Default connection details assume a Logstash instance running locally on the standard port. You can override the API base URL at runtime by setting the LOGSTASH_API_BASE environment variable.

To interact with the web UI for related visualization, you would typically run the provided web interface, but the MCP server itself is started with the command shown above.

Available tools

logstash_check_connectivity

Check connectivity to the Logstash instance with detailed connection status, response times, and error handling.

logstash_node_info

Get Logstash node information including version, build info, and settings.

logstash_node_stats

Get comprehensive node statistics including JVM, process, and pipeline metrics.

logstash_pipelines_stats

Get statistics for all Logstash pipelines.

logstash_pipeline_stats

Get statistics for a specific pipeline by id.

logstash_hot_threads

Get hot threads information for debugging performance issues.

logstash_plugins

List all installed Logstash plugins.

check_backpressure

Check queue backpressure metrics to monitor pipeline performance and congestion.

logstash_health_check

Perform comprehensive health check with analysis and recommendations.

logstash_jvm_stats

Get detailed JVM statistics for memory analysis.

logstash_health_report

Get detailed health report from Logstash.

flow_metrics

Get detailed flow metrics including throughput, backpressure, and worker concurrency.