From 829ba18c435f8073ce3ea03c2dded6038a503c8a Mon Sep 17 00:00:00 2001
From: lcawl <lcawley@elastic.co>
Date: Thu, 12 Feb 2026 10:26:10 -0800
Subject: [PATCH 1/4] Add changelog configuration file

---
 docs/changelog.yml | 130 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 130 insertions(+)
 create mode 100644 docs/changelog.yml

diff --git a/docs/changelog.yml b/docs/changelog.yml
new file mode 100644
index 0000000000..f662fb0753
--- /dev/null
+++ b/docs/changelog.yml
@@ -0,0 +1,130 @@
+# Changelog Configuration
+# This file configures the valid values for changelog fields using the pivot structure.
+# Place this file as `changelog.yml` in the `docs/` directory
+
+# Products configuration (optional)
+# If not specified, all products from products.yml are allowed
+products:
+  # List of available product IDs (empty = all from products.yml)
+  available:
+    - logstash
+  # Default products when --products not specified
+  default:
+    - product: logstash
+      lifecycle: ga
+
+# Extraction configuration
+# Controls automatic extraction of information from PR descriptions
+extract:
+  # Auto-extract release notes from PR descriptions (default: true)
+  # Can be overridden by CLI --no-extract-release-notes
+  release_notes: true
+  # Auto-extract issues from PR body (default: true)
+  # Looks for patterns like "Fixes #123", "Closes #456", etc.
+  issues: true
+
+# Available lifecycle values (strongly typed: preview, beta, ga)
+lifecycles:
+  - preview
+  - beta
+  - ga
+
+# Pivot configuration for types, subtypes, and areas with label mappings.
+# By default we render entries grouped by type > subtype > area.
+# NOTE: subtype and area are optional and either may be omitted.
+# Labels are specified in a "label -> value" format
+pivot:
+  # Type definitions with optional labels
+  # At a minimum, feature, bug-fix, and breaking-change must be configured.
+  # Keys are type names, values can be:
+  #   - simple string: comma-separated label list (e.g., ">bug, >fix")
+  #   - empty/null: no labels for this type
+  #   - object: { labels: "...", subtypes: {...} } for breaking-change type only
+  types:
+    # Complex object form with subtypes (ONLY allowed for breaking-change)
+    # Subtypes help categorize breaking changes by their nature
+    breaking-change:
+      labels: "breaking change"
+      # subtypes:
+      #   api: ">api-breaking"
+      #   behavioral: ">behavioral-breaking"
+      #   configuration: ">config-breaking"
+      #   dependency: ">dependency-breaking"
+      #   subscription: ">subscription-breaking"
+      #   plugin: ">plugin-breaking"
+      #   security: ">security-breaking"
+      #   other:
+    # Simple string form: labels as comma-separated string
+    bug-fix: ">bug, bug"
+    deprecation: "deprecation"
+    feature:
+    enhancement: "enhancement"
+    docs: "docs"
+    known-issue:
+    other:
+    regression: "regression"
+    security:
+
+  # Area definitions with labels
+  # Keys are area display names, values are label strings
+  # Multiple labels can be comma-separated
+  # areas:
+    # Example mappings - customize based on your label naming conventions
+    # Autoscaling: ":Distributed Coordination/Autoscaling"
+    # Search: ":Search/Search"
+    # Security: ":Security/Security"
+    # Watcher: ":Data Management/Watcher"
+
+# Block configuration - combined create and publish blockers
+# block:
+  # Global labels that block changelog creation for all products (comma-separated string)
+  # create: ">non-issue, >test"
+
+  # Block changelog entries from publishing based on entry type or area
+  # publish:
+  #   types:
+  #     - deprecation
+  #     - known-issue
+  #   areas:
+  #     - "Internal"
+
+  # Product-specific overrides (override global blockers, don't merge)
+  # Dictionary key can be a single product ID or comma-separated product IDs
+  # product:
+    # Example: Block these labels for elasticsearch and kibana
+    # 'elasticsearch, kibana':
+    #   create: ">test"
+    #   publish:
+    #     types:
+    #       - docs
+    # Example: Block ILM label for cloud-serverless
+    # 'cloud-serverless':
+    #   create: "ILM"
+    #   publish:
+    #     areas:
+    #       - "ILM"
+
+# Bundle configuration (profiles and defaults)
+bundle:
+  # Input directory containing changelog YAML files
+  directory: docs/changelog
+  # Output directory for bundled changelog files
+  output_directory: docs/releases
+  # Whether to resolve (copy contents) by default
+  resolve: true
+
+  # Named bundle profiles for different release scenarios
+  # profiles:
+    # Example: Elasticsearch release profile
+    # elasticsearch-release:
+    #   products: "elasticsearch {version} {lifecycle}"
+    #   output: "elasticsearch-{version}.yaml"
+
+    # Example: Serverless release profile
+    # serverless-release:
+    #   products: "cloud-serverless {version} *"
+    #   output: "serverless-{version}.yaml"
+    #   # Feature IDs to hide when bundling with this profile
+    #   hide_features:
+    #     - feature-flag-1
+    #     - feature-flag-2

From 47947b5c4f21a73d63f9e6870af5702181bd474f Mon Sep 17 00:00:00 2001
From: lcawl <lcawley@elastic.co>
Date: Thu, 12 Feb 2026 14:37:44 -0800
Subject: [PATCH 2/4] Add changelogs, bundles, and directives

---
 docs/changelog.yml                            |  4 +-
 docs/changelog/18265.yaml                     | 93 +++++++++++++++++++
 docs/changelog/18377.yaml                     | 92 ++++++++++++++++++
 docs/changelog/18460.yaml                     | 92 ++++++++++++++++++
 docs/releases/logstash-9.3.0.yaml             | 42 +++++++++
 .../logstash-output-elasticsearch-9.3.0.yaml  | 29 ++++++
 6 files changed, 350 insertions(+), 2 deletions(-)
 create mode 100644 docs/changelog/18265.yaml
 create mode 100644 docs/changelog/18377.yaml
 create mode 100644 docs/changelog/18460.yaml
 create mode 100644 docs/releases/logstash-9.3.0.yaml
 create mode 100644 docs/releases/logstash-output-elasticsearch-9.3.0.yaml

diff --git a/docs/changelog.yml b/docs/changelog.yml
index f662fb0753..e80a649fe4 100644
--- a/docs/changelog.yml
+++ b/docs/changelog.yml
@@ -68,9 +68,9 @@ pivot:
   # Area definitions with labels
   # Keys are area display names, values are label strings
   # Multiple labels can be comma-separated
-  # areas:
+  areas:
     # Example mappings - customize based on your label naming conventions
-    # Autoscaling: ":Distributed Coordination/Autoscaling"
+    Elasticsearch Output:
     # Search: ":Search/Search"
     # Security: ":Security/Security"
     # Watcher: ":Data Management/Watcher"
diff --git a/docs/changelog/18265.yaml b/docs/changelog/18265.yaml
new file mode 100644
index 0000000000..63fd69b866
--- /dev/null
+++ b/docs/changelog/18265.yaml
@@ -0,0 +1,93 @@
+##### Required fields #####
+
+# title:
+#   A required string that is a short, user-facing headline.
+#   (Max 80 characters)
+
+# type:
+#   A required string that contains the type of change
+#   It can be one of:
+#   - breaking-change
+#   - bug-fix
+#   - deprecation
+#   - feature
+#   - enhancement
+#   - docs
+#   - known-issue
+#   - other
+#   - regression
+#   - security
+
+# products:
+#   A required array of objects that denote the affected products
+#   Each product object contains:
+#
+#   - product:
+#       A required string with a valid product ID.
+#       Valid values are defined in https://github.com/elastic/docs-builder/blob/main/config/products.yml
+#
+#     target:
+#       An optional string with the target version or date.
+#
+#     lifecycle:
+#       An optional string for new features or enhancements that have a specific availability.
+#       It can be one of:
+#       - preview
+#       - beta
+#       - ga
+
+##### Optional fields #####
+
+# action:
+#   An optional string that describes what users must do to mitigate
+#   the impact of a breaking change or known issue.
+
+# areas:
+#   An optional array of strings that denotes the parts/components/services
+#   of the product that are affected.
+
+# description:
+#   An optional string that provides additional information.
+#   (Max 600 characters).
+
+# feature-id:
+#   An optional string to associate a feature or enhanceent with a
+#   unique feature flag.
+
+# highlight:
+#   An optional boolean for items that should be included in release
+#   highlights or the UI to draw user attention.
+
+# impact:
+#   An optional string that describes how the user's environment is
+#   affected by a breaking change or known issue.
+
+# issues:
+#   An optional array of strings that contain the issues that are
+#   relevant to the PR.
+
+# pr:
+#   An optional string that contains the pull request number.
+
+# subtype:
+#   An optional string that applies only to breaking changes.
+#   It can be one of:
+#   - api
+#   - behavioral
+#   - configuration
+#   - dependency
+#   - subscription
+#   - plugin
+#   - security
+#   - other
+
+pr: "18265"
+issues:
+- https://github.com/elastic/logstash/issues/17980
+- https://github.com/elastic/logstash/issues/18078
+type: bug-fix
+products:
+- product: logstash
+  target: 9.3.0
+title: 'management: confirm server-side filtering 404s'
+description: fixes an issue with Central Management where a spurious 404 when looking up pipeline definitions could cause the running pipelines to shut down.
diff --git a/docs/changelog/18377.yaml b/docs/changelog/18377.yaml
new file mode 100644
index 0000000000..fc6cd069b7
--- /dev/null
+++ b/docs/changelog/18377.yaml
@@ -0,0 +1,92 @@
+##### Required fields #####
+
+# title:
+#   A required string that is a short, user-facing headline.
+#   (Max 80 characters)
+
+# type:
+#   A required string that contains the type of change
+#   It can be one of:
+#   - breaking-change
+#   - bug-fix
+#   - deprecation
+#   - feature
+#   - enhancement
+#   - docs
+#   - known-issue
+#   - other
+#   - regression
+#   - security
+
+# products:
+#   A required array of objects that denote the affected products
+#   Each product object contains:
+#
+#   - product:
+#       A required string with a valid product ID.
+#       Valid values are defined in https://github.com/elastic/docs-builder/blob/main/config/products.yml
+#
+#     target:
+#       An optional string with the target version or date.
+#
+#     lifecycle:
+#       An optional string for new features or enhancements that have a specific availability.
+#       It can be one of:
+#       - preview
+#       - beta
+#       - ga
+
+##### Optional fields #####
+
+# action:
+#   An optional string that describes what users must do to mitigate
+#   the impact of a breaking change or known issue.
+
+# areas:
+#   An optional array of strings that denotes the parts/components/services
+#   of the product that are affected.
+
+# description:
+#   An optional string that provides additional information.
+#   (Max 600 characters).
+
+# feature-id:
+#   An optional string to associate a feature or enhanceent with a
+#   unique feature flag.
+
+# highlight:
+#   An optional boolean for items that should be included in release
+#   highlights or the UI to draw user attention.
+
+# impact:
+#   An optional string that describes how the user's environment is
+#   affected by a breaking change or known issue.
+
+# issues:
+#   An optional array of strings that contain the issues that are
+#   relevant to the PR.
+
+# pr:
+#   An optional string that contains the pull request number.
+
+# subtype:
+#   An optional string that applies only to breaking changes.
+#   It can be one of:
+#   - api
+#   - behavioral
+#   - configuration
+#   - dependency
+#   - subscription
+#   - plugin
+#   - security
+#   - other
+
+pr: "18377"
+issues:
+- https://github.com/elastic/logstash/issues/17457
+type: feature
+products:
+- product: logstash
+  target: 9.3.0
+title: Wait for status feature added to Logstash API
+description: We've added additional wait_for_status and timeout query parameters to the Logstash root endpoint `/`. When calling the endpoint with these parameters set, the call will return when either the Logstash status matches (or improves on) the given status, or the given timeout has expired.
diff --git a/docs/changelog/18460.yaml b/docs/changelog/18460.yaml
new file mode 100644
index 0000000000..099fd3b5f5
--- /dev/null
+++ b/docs/changelog/18460.yaml
@@ -0,0 +1,92 @@
+##### Required fields #####
+
+# title:
+#   A required string that is a short, user-facing headline.
+#   (Max 80 characters)
+
+# type:
+#   A required string that contains the type of change
+#   It can be one of:
+#   - breaking-change
+#   - bug-fix
+#   - deprecation
+#   - feature
+#   - enhancement
+#   - docs
+#   - known-issue
+#   - other
+#   - regression
+#   - security
+
+# products:
+#   A required array of objects that denote the affected products
+#   Each product object contains:
+#
+#   - product:
+#       A required string with a valid product ID.
+#       Valid values are defined in https://github.com/elastic/docs-builder/blob/main/config/products.yml
+#
+#     target:
+#       An optional string with the target version or date.
+#
+#     lifecycle:
+#       An optional string for new features or enhancements that have a specific availability.
+#       It can be one of:
+#       - preview
+#       - beta
+#       - ga
+
+##### Optional fields #####
+
+# action:
+#   An optional string that describes what users must do to mitigate
+#   the impact of a breaking change or known issue.
+
+# areas:
+#   An optional array of strings that denotes the parts/components/services
+#   of the product that are affected.
+
+# description:
+#   An optional string that provides additional information.
+#   (Max 600 characters).
+
+# feature-id:
+#   An optional string to associate a feature or enhanceent with a
+#   unique feature flag.
+
+# highlight:
+#   An optional boolean for items that should be included in release
+#   highlights or the UI to draw user attention.
+
+# impact:
+#   An optional string that describes how the user's environment is
+#   affected by a breaking change or known issue.
+
+# issues:
+#   An optional array of strings that contain the issues that are
+#   relevant to the PR.
+
+# pr:
+#   An optional string that contains the pull request number.
+
+# subtype:
+#   An optional string that applies only to breaking changes.
+#   It can be one of:
+#   - api
+#   - behavioral
+#   - configuration
+#   - dependency
+#   - subscription
+#   - plugin
+#   - security
+#   - other
+
+pr: "18460"
+issues:
+- https://github.com/elastic/logstash/issues/123
+- https://github.com/elastic/logstash/issues/17998
+type: enhancement
+products:
+- product: logstash
+  target: 9.3.0
+title: Exposes batch size metrics for last 1, 5 and 15 minutes.
diff --git a/docs/releases/logstash-9.3.0.yaml b/docs/releases/logstash-9.3.0.yaml
new file mode 100644
index 0000000000..32be2555a2
--- /dev/null
+++ b/docs/releases/logstash-9.3.0.yaml
@@ -0,0 +1,42 @@
+products:
+- product: logstash
+  target: 9.3.0
+  repo: logstash
+entries:
+- file:
+    name: 18265.yaml
+    checksum: ab23acf8567e6f7c32c2e6793fe01ec6f4246706
+  type: bug-fix
+  title: 'management: confirm server-side filtering 404s'
+  products:
+  - product: logstash
+    target: 9.3.0
+  description: fixes an issue with Central Management where a spurious 404 when looking up pipeline definitions could cause the running pipelines to shut down.
+  pr: "18265"
+  issues:
+  - https://github.com/elastic/logstash/issues/17980
+  - https://github.com/elastic/logstash/issues/18078
+- file:
+    name: 18377.yaml
+    checksum: d3891923af101b76f0ee0a08b8bd478162b8bd23
+  type: feature
+  title: Wait for status feature added to Logstash API
+  products:
+  - product: logstash
+    target: 9.3.0
+  description: We've added additional wait_for_status and timeout query parameters to the Logstash root endpoint `/`. When calling the endpoint with these parameters set, the call will return when either the Logstash status matches (or improves on) the given status, or the given timeout has expired.
+  pr: "18377"
+  issues:
+  - https://github.com/elastic/logstash/issues/17457
+- file:
+    name: 18460.yaml
+    checksum: 0791e71c711953b3c6316e14b3dfd2e5d9a8a832
+  type: enhancement
+  title: Exposes batch size metrics for last 1, 5 and 15 minutes.
+  products:
+  - product: logstash
+    target: 9.3.0
+  pr: "18460"
+  issues:
+  - https://github.com/elastic/logstash/issues/123
+  - https://github.com/elastic/logstash/issues/17998
diff --git a/docs/releases/logstash-output-elasticsearch-9.3.0.yaml b/docs/releases/logstash-output-elasticsearch-9.3.0.yaml
new file mode 100644
index 0000000000..e45db908e8
--- /dev/null
+++ b/docs/releases/logstash-output-elasticsearch-9.3.0.yaml
@@ -0,0 +1,29 @@
+products:
+- product: logstash
+  target: 9.3.0
+  repo: logstash-output-elasticsearch
+entries:
+- file:
+    name: 1228.yaml
+    checksum: 01a12f7123a1b3be32c15ec1836c7e6a536b2a5f
+  type: other
+  title: Add drop_error_types config option to not retry after certain error types
+  products:
+  - product: logstash
+    target: 9.3.0
+  areas:
+  - Elasticsearch Output
+  pr: https://github.com/logstash-plugins/logstash-output-elasticsearch/pull/1228
+  issues:
+  - https://github.com/logstash-plugins/logstash-output-elasticsearch/issues/1225
+- file:
+    name: 1232.yaml
+    checksum: 441c187a3367cf87d0575c48a52b941256ce2b95
+  type: other
+  title: Remove duplicated deprecation log entry
+  products:
+  - product: logstash
+    target: 9.3.0
+  areas:
+  - Elasticsearch Output
+  pr: https://github.com/logstash-plugins/logstash-output-elasticsearch/pull/1232

From 6d9c1025b2258ca58028fd086386b41d95f26561 Mon Sep 17 00:00:00 2001
From: lcawl <lcawley@elastic.co>
Date: Wed, 20 May 2026 18:58:38 -0700
Subject: [PATCH 3/4] Refresh changelog.yml

---
 docs/changelog.yml | 181 +++++++++++++++++++++++++++++++++++----------
 1 file changed, 140 insertions(+), 41 deletions(-)

diff --git a/docs/changelog.yml b/docs/changelog.yml
index e80a649fe4..ddebc17ea1 100644
--- a/docs/changelog.yml
+++ b/docs/changelog.yml
@@ -1,9 +1,26 @@
 # Changelog Configuration
 # This file configures the valid values for changelog fields using the pivot structure.
 # Place this file as `changelog.yml` in the `docs/` directory
+#
+# NOTE: All list-like fields accept BOTH forms:
+#   - Comma-separated string: "value1, value2, value3"
+#   - YAML list:
+#     - value1
+#     - value2
+#     - value3
+# Both forms produce the same result. Choose whichever is more readable for your use case.
+
+# Filename strategy for generated changelog files.
+# Controls how files created by 'changelog add' are named.
+#   pr        — use the PR number (e.g., 12345.yaml).
+#   issue     — use the issue number (e.g., 67890.yaml).
+#   timestamp — use a Unix timestamp with a title slug (e.g., 1735689600-fix-search.yaml). Default.
+# Can be overridden per invocation with --use-pr-number or --use-issue-number CLI flags.
+filename: pr
 
 # Products configuration (optional)
-# If not specified, all products from products.yml are allowed
+# If not specified, all products from products.yml are allowed (including those
+# that have 'public-reference' disabled).
 products:
   # List of available product IDs (empty = all from products.yml)
   available:
@@ -11,7 +28,7 @@ products:
   # Default products when --products not specified
   default:
     - product: logstash
-      lifecycle: ga
+      # lifecycle: ga
 
 # Extraction configuration
 # Controls automatic extraction of information from PR descriptions
@@ -22,6 +39,9 @@ extract:
   # Auto-extract issues from PR body (default: true)
   # Looks for patterns like "Fixes #123", "Closes #456", etc.
   issues: true
+  # Remove square-bracket prefixes from PR titles (default: false)
+  # When enabled (true or via --strip-title-prefix), titles like "[ES|QL] Fix bug" become "Fix bug".
+  strip_title_prefix: false
 
 # Available lifecycle values (strongly typed: preview, beta, ga)
 lifecycles:
@@ -70,39 +90,89 @@ pivot:
   # Multiple labels can be comma-separated
   areas:
     # Example mappings - customize based on your label naming conventions
-    Elasticsearch Output:
+    # Elasticsearch Output:
     # Search: ":Search/Search"
     # Security: ":Security/Security"
     # Watcher: ":Data Management/Watcher"
 
-# Block configuration - combined create and publish blockers
-# block:
-  # Global labels that block changelog creation for all products (comma-separated string)
-  # create: ">non-issue, >test"
+# Product definitions with labels (optional).
+  # Keys are product spec strings; values are label strings or lists that trigger that product.
+  # A product spec string is: "<product-id> [<target-version>] [<lifecycle>]"
+  #   - Product ID only:           "elasticsearch"
+  #   - Product + target:          "kibana 9.2.0"
+  #   - Full spec:                 "cloud-serverless 2025-06 ga"
+  # When a PR has labels matching any product entry, all matching products are added.
+  # Precedence: --products CLI option > pivot.products label mapping > products.default > repo inference.
+  #
+  # products:
+  #   'elasticsearch':
+  #     - ":stack/elasticsearch"
+  #   'kibana':
+  #     - ":stack/kibana"
+  #   'cloud-serverless':
+  #     - ":cloud/serverless"
+  #   # Specify a target version if known:
+  #   # 'elasticsearch 9.2.0':
+  #   #   - ":feature/new-in-9.2"
+
+# Rules configuration — controls which PRs create changelogs and which changelogs are published.
+# All list-like fields (exclude, include, exclude_types) accept BOTH forms:
+#   - Comma-separated string: "value1, value2, value3"
+#   - YAML list: [value1, value2, value3]
+#
+# For details and examples, refer to the [rules documentation](https://github.com/elastic/docs-builder/blob/main/docs/contribute/configure-changelogs-ref.md#rules).
+rules:
+  # match: any
 
-  # Block changelog entries from publishing based on entry type or area
-  # publish:
-  #   types:
-  #     - deprecation
-  #     - known-issue
-  #   areas:
-  #     - "Internal"
+  # Create — controls which PRs generate changelogs.
+  # create:
+  #   exclude: ">non-issue, >test"
+  #   # Or equivalently:
+  #   # exclude:
+  #   #   - ">non-issue"
+  #   #   - ">test"
+  #   # match: any
+  #   products:
+  #     'elasticsearch, kibana':
+  #       exclude: ">test"
+  #     'cloud-serverless':
+  #       exclude: "ILM"
 
-  # Product-specific overrides (override global blockers, don't merge)
-  # Dictionary key can be a single product ID or comma-separated product IDs
-  # product:
-    # Example: Block these labels for elasticsearch and kibana
-    # 'elasticsearch, kibana':
-    #   create: ">test"
-    #   publish:
-    #     types:
-    #       - docs
-    # Example: Block ILM label for cloud-serverless
-    # 'cloud-serverless':
-    #   create: "ILM"
-    #   publish:
-    #     areas:
-    #       - "ILM"
+  # Bundle — filtering applied during 'changelog bundle' and 'changelog gh-release'.
+  # See https://github.com/elastic/docs-builder/blob/main/docs/contribute/configure-changelogs-ref.md#rules-bundle for Mode 1 / 2 / 3 behavior.
+  #
+  # Mode 2 (global content): use global lists only — no `products` key, or `products: {}`.
+  # Example — include changelogs that list elasticsearch OR kibana (evaluated per changelog):
+  # bundle:
+  #   match_products: any
+  #   include_products:
+  #     - elasticsearch
+  #     - kibana
+  #   exclude_types: "deprecation, known-issue"
+  #
+  # Example — exclude only when the changelog lists BOTH products (conjunction); extras allowed:
+  # bundle:
+  #   match_products: conjunction
+  #   exclude_products:
+  #     - kibana
+  #     - observability
+  #
+  # Mode 3 (per-product context): non-empty `rules.bundle.products` — global include/exclude/type/area
+  # under `bundle:` are NOT applied for filtering; configure filters under each product key.
+  # Example:
+  # bundle:
+  #   exclude_types: [docs]   # ignored for filtering in Mode 3 — duplicate under each product if needed
+  #   products:
+  #     observability:
+  #       exclude_products: ["cloud-enterprise"]
+  #       exclude_types: ["docs"]
+  #       include_areas:
+  #         - "APM"
+  #         - "Infrastructure monitoring"
+  #     kibana:
+  #       match_products: all
+  #       include_products: ["kibana", "security"]
+  #       exclude_types: ["docs"]
 
 # Bundle configuration (profiles and defaults)
 bundle:
@@ -112,19 +182,48 @@ bundle:
   output_directory: docs/releases
   # Whether to resolve (copy contents) by default
   resolve: true
+  # description: |
+  #   This release includes new features and bug fixes.
+  # To allow cross-repo links, add more owner/repo entries.
+  link_allow_repos:
+    - elastic/beats
+    - elastic/elasticsearch
+    - elastic/kibana
+    - elastic/logstash
+    - elastic/logstash-docs
+    - logstash-plugins/logstash-output-elasticsearch
+    - elastic/roadmap
+  # Optional: default GitHub repo name applied to all profiles that do not specify their own.
+  repo: logstash
+  # Optional: default GitHub owner applied to all profiles that do not specify their own.
+  owner: elastic
+  # Optional: control auto-population of release-date for all profiles by default.
+  # release_dates: true
 
-  # Named bundle profiles for different release scenarios
-  # profiles:
-    # Example: Elasticsearch release profile
-    # elasticsearch-release:
-    #   products: "elasticsearch {version} {lifecycle}"
-    #   output: "elasticsearch-{version}.yaml"
-
-    # Example: Serverless release profile
-    # serverless-release:
-    #   products: "cloud-serverless {version} *"
-    #   output: "serverless-{version}.yaml"
-    #   # Feature IDs to hide when bundling with this profile
+  # Named bundle profiles for different release scenarios.
+  # Profiles can be used with both 'changelog bundle' and 'changelog remove':
+  #   docs-builder changelog bundle elasticsearch-release 9.2.0
+  #   docs-builder changelog remove elasticsearch-release 9.2.0
+  # When used with 'changelog remove', only the 'products' field is applied.
+  # The 'output', 'output_products', 'repo', 'owner', and 'hide_features' fields are
+  # bundle-specific and are ignored for removal.
+  profiles:
+    logstash-release:
+    #   Output filename ({version} is substituted at runtime)
+      output: "logstash-{version}.yaml"
+    #   Override the products array written to the bundle output.
+      output_products: "logstash {version}"
+    #   # Optional: profile-specific description (overrides bundle.description)
+    #   # description: |
+    #   #   Elasticsearch {version} includes:
+    #   #   - Performance improvements
+    #   #   - Bug fixes and stability enhancements
+    #   #   
+    #   #   Download the release binaries: https://github.com/{owner}/{repo}/releases/tag/v{version}
+    #   # Optional: control auto-population of release-date for this profile.
+    #   # When true (default), auto-populate release dates. When false, equivalent to --no-release-date.
+    #   # release_dates: true
+    #   # Feature IDs to hide when bundling with this profile (accepts string or list)
     #   hide_features:
     #     - feature-flag-1
     #     - feature-flag-2

From 83f04bde938508d80f1dfa3b895f8b9bf4d730ff Mon Sep 17 00:00:00 2001
From: lcawl <lcawley@elastic.co>
Date: Wed, 20 May 2026 19:50:11 -0700
Subject: [PATCH 4/4] Add 9.4 changelogs

---
 docs/changelog.yml                            |  6 +-
 ...rics-that-exposes-batch-size-and-coun.yaml |  8 +++
 docs/changelog/18680.yaml                     |  7 +++
 docs/changelog/18930.yaml                     | 13 +++++
 docs/changelog/19013.yaml                     |  8 +++
 docs/releases/logstash-9.4.0.yaml             | 58 +++++++++++++++++++
 6 files changed, 97 insertions(+), 3 deletions(-)
 create mode 100644 docs/changelog/1779330447-implement-metrics-that-exposes-batch-size-and-coun.yaml
 create mode 100644 docs/changelog/18680.yaml
 create mode 100644 docs/changelog/18930.yaml
 create mode 100644 docs/changelog/19013.yaml
 create mode 100644 docs/releases/logstash-9.4.0.yaml

diff --git a/docs/changelog.yml b/docs/changelog.yml
index ddebc17ea1..7c59d55794 100644
--- a/docs/changelog.yml
+++ b/docs/changelog.yml
@@ -41,7 +41,7 @@ extract:
   issues: true
   # Remove square-bracket prefixes from PR titles (default: false)
   # When enabled (true or via --strip-title-prefix), titles like "[ES|QL] Fix bug" become "Fix bug".
-  strip_title_prefix: false
+  strip_title_prefix: true
 
 # Available lifecycle values (strongly typed: preview, beta, ga)
 lifecycles:
@@ -190,8 +190,8 @@ bundle:
     - elastic/elasticsearch
     - elastic/kibana
     - elastic/logstash
-    - elastic/logstash-docs
-    - logstash-plugins/logstash-output-elasticsearch
+    # - elastic/logstash-docs
+    # - logstash-plugins/logstash-output-elasticsearch
     - elastic/roadmap
   # Optional: default GitHub repo name applied to all profiles that do not specify their own.
   repo: logstash
diff --git a/docs/changelog/1779330447-implement-metrics-that-exposes-batch-size-and-coun.yaml b/docs/changelog/1779330447-implement-metrics-that-exposes-batch-size-and-coun.yaml
new file mode 100644
index 0000000000..3b38e49b72
--- /dev/null
+++ b/docs/changelog/1779330447-implement-metrics-that-exposes-batch-size-and-coun.yaml
@@ -0,0 +1,8 @@
+issues:
+- "17838"
+type: enhancement
+products:
+- product: logstash
+  target: 9.4.0
+title: New batch histogram metrics
+description: "We've improved visibility of batch sizing batch sizing at a pipeline level by exposing new histogram-type metrics in the`GET /_node/stats` endpoint. These metrics show the distribution of batch sizes in bytes and event-count for the lifetime of the pipeline, as well as for the most recent 1, 5, and 15-minute time windows."
diff --git a/docs/changelog/18680.yaml b/docs/changelog/18680.yaml
new file mode 100644
index 0000000000..df497b27dc
--- /dev/null
+++ b/docs/changelog/18680.yaml
@@ -0,0 +1,7 @@
+prs:
+- "18680"
+type: enhancement
+products:
+- product: logstash
+  target: 9.4.0
+title: Add new config option to split batch into chunks before outputs
diff --git a/docs/changelog/18930.yaml b/docs/changelog/18930.yaml
new file mode 100644
index 0000000000..915867d9c2
--- /dev/null
+++ b/docs/changelog/18930.yaml
@@ -0,0 +1,13 @@
+prs:
+- "18930"
+type: enhancement
+products:
+- product: logstash
+  target: 9.4.0
+title: Reactive pipline recovery
+description: |-
+  This release adds a feature to recover from pipeline crashes, under the setting `pipeline.recovery`. Crash recovery is applied when `config.reload.automatic` is enabled and accepts the following values:
+  
+  - `auto`: enables pipeline crash recovery for pipelines backed by the persistent queue
+  - `false` (default): do not automate recovery of crashed pipelines
+  - `true`: enables pipeline crash recovery for any pipeline, even if backed by the ephemeral memory queue (risk: data loss).
\ No newline at end of file
diff --git a/docs/changelog/19013.yaml b/docs/changelog/19013.yaml
new file mode 100644
index 0000000000..f423606d72
--- /dev/null
+++ b/docs/changelog/19013.yaml
@@ -0,0 +1,8 @@
+prs:
+- "19013"
+type: enhancement
+products:
+- product: logstash
+  target: 9.4.0
+title: 'Optimize DLQ segment directory scans with single-pass logic'
+description: Performance improvements which saves ~40% CPU resource on DLQ segment file lookup operations.
diff --git a/docs/releases/logstash-9.4.0.yaml b/docs/releases/logstash-9.4.0.yaml
new file mode 100644
index 0000000000..748c09b43e
--- /dev/null
+++ b/docs/releases/logstash-9.4.0.yaml
@@ -0,0 +1,58 @@
+products:
+- product: logstash
+  target: 9.4.0
+  repo: logstash
+  owner: elastic
+release-date: 2026-05-21
+entries:
+- file:
+    name: 18930.yaml
+    checksum: 7334b2823ab466080a4857d1300b260e844ba48d
+  type: enhancement
+  title: Reactive pipline recovery
+  products:
+  - product: logstash
+    target: 9.4.0
+  description: >-
+    This release adds a feature to recover from pipeline crashes, under the setting `pipeline.recovery`. Crash recovery is applied when `config.reload.automatic` is enabled and accepts the following values:
+
+
+    - `auto`: enables pipeline crash recovery for pipelines backed by the persistent queue
+
+    - `false` (default): do not automate recovery of crashed pipelines
+
+    - `true`: enables pipeline crash recovery for any pipeline, even if backed by the ephemeral memory queue (risk: data loss).
+  prs:
+  - "18930"
+- file:
+    name: 18680.yaml
+    checksum: 0fb62057efbd4978f799ef6d11d49fa315ef8ed8
+  type: enhancement
+  title: Add new config option to split batch into chunks before outputs
+  products:
+  - product: logstash
+    target: 9.4.0
+  prs:
+  - "18680"
+- file:
+    name: 19013.yaml
+    checksum: c97c17f8cde6a003e16e9729a28c4c7f39db4577
+  type: enhancement
+  title: Optimize DLQ segment directory scans with single-pass logic
+  products:
+  - product: logstash
+    target: 9.4.0
+  description: Performance improvements which saves ~40% CPU resource on DLQ segment file lookup operations.
+  prs:
+  - "19013"
+- file:
+    name: 1779330447-implement-metrics-that-exposes-batch-size-and-coun.yaml
+    checksum: 16c974cb73d87a1cb0909c0b978dc7a1cdc383e5
+  type: enhancement
+  title: New batch histogram metrics
+  products:
+  - product: logstash
+    target: 9.4.0
+  description: We've improved visibility of batch sizing batch sizing at a pipeline level by exposing new histogram-type metrics in the`GET /_node/stats` endpoint. These metrics show the distribution of batch sizes in bytes and event-count for the lifetime of the pipeline, as well as for the most recent 1, 5, and 15-minute time windows.
+  issues:
+  - "17838"