Skip to content

Bad link report: fixing broken links and redirected URLs#2407

Merged
esmerel merged 4 commits intomasterfrom
lynettemiles/sc-165492/fluent-bit-bad-links-march-2026
Mar 3, 2026
Merged

Bad link report: fixing broken links and redirected URLs#2407
esmerel merged 4 commits intomasterfrom
lynettemiles/sc-165492/fluent-bit-bad-links-march-2026

Conversation

@esmerel
Copy link
Contributor

@esmerel esmerel commented Mar 3, 2026

This PR fixes most of the issues in #2403 by correcting the broken links (aside from what @alexakreizinger fixed in #2406). It also updates a whole bunch of links which were going through up to four (!!) redirects (mostly due to one company).

next month's link report should look much cleaner.

Summary by CodeRabbit

  • Documentation
    • Updated numerous external links and repository references across docs for plugins, inputs, outputs, filters, and guides.
    • Normalized URL formatting (trailing slashes, domains) for consistency.
    • Added and clarified documentation configuration examples and parameter entries in several output guides.
    • Minor table and formatting improvements for readability.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Mar 3, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 8ce4465 and da1bec4.

📒 Files selected for processing (2)
  • pipeline/outputs/treasure-data.md
  • pipeline/outputs/vivo-exporter.md

📝 Walkthrough

Walkthrough

This PR updates and normalizes external documentation links and formatting across many markdown files—adjusting domains, trailing slashes, GitHub repo references, and some table formatting; no code, API, or control-flow changes were made.

Changes

Cohort / File(s) Summary
General docs & repo root
CONTRIBUTING.md, README.md, about/fluentd-and-fluent-bit.md, administration/monitoring.md, installation/downloads.md
Trailing-slash and domain normalization for top-level links and contributor/setup docs.
Google Cloud / Stackdriver / BigQuery
pipeline/outputs/bigquery.md, pipeline/outputs/chronicle.md, pipeline/outputs/stackdriver.md, pipeline/outputs/stackdriver_special_fields.md
Repointed legacy cloud.google.com links to docs.cloud.google.com and adjusted related anchors, credentials, and navigation links.
Library & GitHub references
pipeline/filters/kubernetes.md, pipeline/inputs/kafka.md, pipeline/outputs/kafka.md, pipeline/outputs/vivo-exporter.md
Updated upstream GitHub repo references (e.g., fabric8io → fluent-plugins-nursery; edenhill/librdkafka → confluentinc/librdkafka) and related link text.
Third-party service outputs
pipeline/outputs/datadog.md, pipeline/outputs/dynatrace.md, pipeline/outputs/elasticsearch.md, pipeline/outputs/firehose.md, pipeline/outputs/gelf.md, pipeline/outputs/influxdb.md, pipeline/outputs/loki.md, pipeline/outputs/observe.md, pipeline/outputs/openobserve.md, pipeline/outputs/parseable.md, pipeline/outputs/prometheus-remote-write.md, pipeline/outputs/slack.md, pipeline/outputs/treasure-data.md
Fixed and standardized external vendor/service URLs, introduced some expanded config examples or extra documented config keys in a few files, and normalized table syntax/formatting.
AWS / S3 / CloudWatch
pipeline/outputs/cloudwatch.md, pipeline/outputs/s3.md
Corrected AWS/ECR/S3 links, adjusted MinIO URL and example labeling, and normalized API reference links.
Parsers & inputs
pipeline/parsers/configuring-parser.md, pipeline/parsers/regular-expression.md, pipeline/inputs/cpu-metrics.md, pipeline/inputs/kafka.md, pipeline/inputs/windows-event-log-winevtlog.md
Switched TZ/Rubular links to updated sources, normalized Fluentd link domains, updated librdkafka reference, and corrected XPath MDN path.
Formatting / tables / minor link tweaks
pipeline/filters/aws-metadata.md, pipeline/outputs/tcp-and-tls.md, pipeline/outputs/s3.md, pipeline/outputs/chronicle.md
Minor table/header reformatting and small inline link or code-style adjustments; one table cell formatting fix in chronicle.md.

Sequence Diagram(s)

(omitted — changes are documentation-only and do not introduce new multi-component control flow)

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

Suggested reviewers

  • eschabell
  • alexakreizinger

Poem

🐰 I hopped through docs both near and far,
Tweaked links and slashes, a tiny star,
Redirects mended, references neat,
Tables aligned, examples complete,
A hop, a fix — documentation sweet.

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: fixing broken links and redirected URLs throughout documentation files in the repository.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch lynettemiles/sc-165492/fluent-bit-bad-links-march-2026

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@eschabell eschabell self-assigned this Mar 3, 2026
@eschabell eschabell added the 5.0 label Mar 3, 2026
@eschabell
Copy link
Collaborator

@esmerel caught red handed by the linter!!!! :-P

@eschabell eschabell added waiting-on-review Waiting on a review from mainteners lint-vale-issues labels Mar 3, 2026
@esmerel esmerel mentioned this pull request Mar 3, 2026
@esmerel esmerel marked this pull request as ready for review March 3, 2026 17:48
@esmerel esmerel requested review from a team and eschabell as code owners March 3, 2026 17:48
@esmerel
Copy link
Contributor Author

esmerel commented Mar 3, 2026

@esmerel caught red handed by the linter!!!! :-P

in my defense, that error was there before and if folks don't know what a CVE is... they probably aren't using Fluent Bit :D

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 5

🧹 Nitpick comments (2)
pipeline/outputs/slack.md (1)

5-5: Optional wording trim for readability.

Line 5 can be tightened by replacing “in conjunction with” with “with” to keep the sentence more direct.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@pipeline/outputs/slack.md` at line 5, Replace the phrase "in conjunction with
the Stream Processor" with "with the Stream Processor" in the sentence that
currently reads "Using this plugin in conjunction with the Stream Processor is a
good combination for alerting." so it becomes more direct and reads "Using this
plugin with the Stream Processor is a good combination for alerting."
pipeline/outputs/stackdriver.md (1)

258-258: Consider standardizing Google Cloud domain usage.

Line 258 uses both cloud.google.com (for log-based metrics) and docs.cloud.google.com in the same section. While both may be valid, consider whether all documentation references should consistently use docs.cloud.google.com to minimize redirect chains.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@pipeline/outputs/stackdriver.md` at line 258, The section referencing "Log
Router rules" and "log-based metrics" uses two different Google domains
(docs.cloud.google.com and cloud.google.com); update the `log-based metrics`
link to use the docs.cloud.google.com domain (matching the "Log Router rules"
link) so both references consistently use docs.cloud.google.com and avoid
unnecessary redirects—locate the links in the paragraph that mentions
"integration with Log Router rules" and "controlling cardinality of log based
metrics" and replace the cloud.google.com URL with its docs.cloud.google.com
equivalent.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@pipeline/outputs/dynatrace.md`:
- Line 86: Rename the Markdown link label that currently reads "[Blog: Easily
stream logs from Fluent Bit to Dynatrace]" to a neutral technical label like
"Documentation: Easily stream logs from Fluent Bit to Dynatrace" so it correctly
reflects that the target URL points to product documentation; update the link
text in the same line (the visible label portion before the URL) to remove the
"Blog" prefix and replace with "Documentation" (or "Docs") to keep the content
technical and non-promotional.

In `@pipeline/outputs/prometheus-remote-write.md`:
- Line 239: Replace the promotional Levitate URL in the markdown link "With
[Levitate](https://last9.io/)" so it points to the official Prometheus
integration docs; update the link target to
https://docs.last9.io/docs/integrations-prometheus/ while keeping the link text
"Levitate" and the surrounding sentence intact.

In `@pipeline/outputs/stackdriver.md`:
- Around line 272-273: The troubleshooting section currently displays clickable
links that point to documentation instead of the actual API endpoints; update
the two link entries for "https://www.googleapis.com" and
"https://logging.googleapis.com" so that their hrefs point to the actual
endpoints (https://www.googleapis.com and https://logging.googleapis.com) or
alternatively change the link text to indicate they are documentation (e.g.,
"Docs: https://cloud.google.com/apis" and "Docs:
https://docs.cloud.google.com/logging/docs/apis") and add a clarifying sentence
telling users to whitelist the real endpoints (https://www.googleapis.com and
https://logging.googleapis.com) in their firewall rules.

In `@pipeline/outputs/treasure-data.md`:
- Line 11: The Treasure Data console URL in the API key description is wrong;
update the URL in the table cell that mentions `API` (the line containing "`API`
| The Treasure Data API key... | _none_") to use the correct US console URL
`https://console.treasuredata.com/users/sign_in` instead of
`https://console.us01.treasuredata.com/users/sign_in`.

In `@pipeline/outputs/vivo-exporter.md`:
- Line 3: In the Vivo Exporter README intro sentence ("Vivo Exporter is an
output plugin... [Vivo project](https://github.com/chronosphereio/calyptia-vivo)
."), remove the stray space before the period so the link is immediately
followed by the period, and adjust the wording to keep a neutral, technical tone
(e.g., retain "is an output plugin that exposes logs, metrics, and traces
through an HTTP endpoint" without promotional phrasing); update the sentence in
the file content for "Vivo Exporter" accordingly.

---

Nitpick comments:
In `@pipeline/outputs/slack.md`:
- Line 5: Replace the phrase "in conjunction with the Stream Processor" with
"with the Stream Processor" in the sentence that currently reads "Using this
plugin in conjunction with the Stream Processor is a good combination for
alerting." so it becomes more direct and reads "Using this plugin with the
Stream Processor is a good combination for alerting."

In `@pipeline/outputs/stackdriver.md`:
- Line 258: The section referencing "Log Router rules" and "log-based metrics"
uses two different Google domains (docs.cloud.google.com and cloud.google.com);
update the `log-based metrics` link to use the docs.cloud.google.com domain
(matching the "Log Router rules" link) so both references consistently use
docs.cloud.google.com and avoid unnecessary redirects—locate the links in the
paragraph that mentions "integration with Log Router rules" and "controlling
cardinality of log based metrics" and replace the cloud.google.com URL with its
docs.cloud.google.com equivalent.

ℹ️ Review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 286898d and 8ce4465.

📒 Files selected for processing (34)
  • CONTRIBUTING.md
  • README.md
  • about/fluentd-and-fluent-bit.md
  • administration/monitoring.md
  • installation/downloads.md
  • pipeline/filters/aws-metadata.md
  • pipeline/filters/kubernetes.md
  • pipeline/inputs/cpu-metrics.md
  • pipeline/inputs/kafka.md
  • pipeline/inputs/windows-event-log-winevtlog.md
  • pipeline/outputs/bigquery.md
  • pipeline/outputs/chronicle.md
  • pipeline/outputs/cloudwatch.md
  • pipeline/outputs/datadog.md
  • pipeline/outputs/dynatrace.md
  • pipeline/outputs/elasticsearch.md
  • pipeline/outputs/firehose.md
  • pipeline/outputs/gelf.md
  • pipeline/outputs/influxdb.md
  • pipeline/outputs/kafka.md
  • pipeline/outputs/loki.md
  • pipeline/outputs/observe.md
  • pipeline/outputs/openobserve.md
  • pipeline/outputs/parseable.md
  • pipeline/outputs/prometheus-remote-write.md
  • pipeline/outputs/s3.md
  • pipeline/outputs/slack.md
  • pipeline/outputs/stackdriver.md
  • pipeline/outputs/stackdriver_special_fields.md
  • pipeline/outputs/tcp-and-tls.md
  • pipeline/outputs/treasure-data.md
  • pipeline/outputs/vivo-exporter.md
  • pipeline/parsers/configuring-parser.md
  • pipeline/parsers/regular-expression.md

### Levitate

With [Levitate](https://last9.io/levitate-tsdb), you must use the Levitate cluster-specific write URL and specify the HTTP username and password for the token created for your Levitate cluster.
With [Levitate](https://last9.io/), you must use the Levitate cluster-specific write URL and specify the HTTP username and password for the token created for your Levitate cluster.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🌐 Web query:

Last9 Levitate Prometheus remote_write documentation setup

💡 Result:

To set up Prometheus remote_write to Last9 Levitate (TSDB), configure Prometheus to send samples to Last9’s remote-write endpoint and restart Prometheus.

1) Get your Last9 remote_write URL

A commonly documented URL template for Last9 is:
https://<user>:<password>@read-app-tsdb.last9.io/hot/v1/metrics/<PID>/sender/<account> [1]

(You’ll replace <PID>, <account>, and credentials with values from your Last9 workspace/org.)

2) Add remote_write to prometheus.yml

Use either inline user/pass in the URL (as above) or (recommended) basic_auth:

remote_write:
  - name: last9-levitate
    url: https://read-app-tsdb.last9.io/hot/v1/metrics/<PID>/sender/<account>
    basic_auth:
      username: <user>
      password: <password>

Prometheus supports remote_write.url, basic_auth, custom headers, write_relabel_configs, and other settings in this stanza. [2]

3) Restart Prometheus and verify

After restart, verify remote-write health via Prometheus logs and/or remote-write metrics (and tune queue_config if you’re back-pressuring or dropping data). [3]

Sources: Last9 endpoint template [1], Prometheus remote_write config reference [2], Prometheus remote_write behavior/tuning guidance [3].


🌐 Web query:

Last9 official documentation portal Levitate TSDB docs

💡 Result:

Official Last9 (Levitate TSDB) documentation portal and relevant Levitate/TSDB docs:

https://docs.last9.io/docs/
https://docs.last9.io/docs/integrations-prometheus/   (Prometheus remote_write → Last9/Levitate)
https://docs.last9.io/docs/change-events              (Change Events, often used alongside Levitate)
https://last9.io/levitate-tsdb/                       (Levitate TSDB product page)

[1] (docs.last9.io)
[2] (docs.last9.io)
[3] (last9.io)

Citations:


Update Levitate link to official documentation.

Line 239 currently links to the company homepage (https://last9.io/), which is promotional rather than technical. Replace it with the official Prometheus integration documentation: https://docs.last9.io/docs/integrations-prometheus/

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@pipeline/outputs/prometheus-remote-write.md` at line 239, Replace the
promotional Levitate URL in the markdown link "With
[Levitate](https://last9.io/)" so it points to the official Prometheus
integration docs; update the link target to
https://docs.last9.io/docs/integrations-prometheus/ while keeping the link text
"Levitate" and the surrounding sentence intact.

esmerel and others added 2 commits March 3, 2026 10:11
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Signed-off-by: Lynette  Miles <[email protected]>
Copy link
Member

@alexakreizinger alexakreizinger left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

:shipit:

@esmerel esmerel merged commit 48b7979 into master Mar 3, 2026
6 of 7 checks passed
@esmerel esmerel deleted the lynettemiles/sc-165492/fluent-bit-bad-links-march-2026 branch March 3, 2026 18:20
@eschabell eschabell removed waiting-on-review Waiting on a review from mainteners lint-vale-issues labels Mar 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants