Skip to content

Observability updates for Kubernetes - #990

Merged
Nadine2016 merged 13 commits into
mainfrom
nadine/kubernetes-observability-restructure
Sep 1, 2026
Merged

Observability updates for Kubernetes#990
Nadine2016 merged 13 commits into
mainfrom
nadine/kubernetes-observability-restructure

Conversation

@Nadine2016

Copy link
Copy Markdown
Collaborator

No description provided.

Nadine2016 and others added 4 commits August 26, 2026 16:47
…og docs

- Add kubernetes observability/access-logs section (view.md, export.md) with OTLP export via Policy CRD backendRef
- Add kubernetes observability/metrics section (control-plane-metrics.md, nacks.md)
- Add kubernetes observability/traces section (setup.md)
- Update observability/_index.md with navigation table
- Add redirects from old paths: security/access-logging, observability/tracing, observability/control-plane-metrics, observability/nacks
- Fix standalone access-logs/export.md: correct OTLP filter fallback behavior
- Fix standalone access-logs/database.md: add json_extract/->>'key' query examples for custom fields

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Nadine2016 <nadine.spies@solo.io>
Signed-off-by: Nadine2016 <nadine.spies@solo.io>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 28, 2026

Copy link
Copy Markdown

Deploying agentproxy with  Cloudflare Pages  Cloudflare Pages

Latest commit: be1d1b6
Status:⚡️  Build in progress...

View logs

Nadine2016 and others added 7 commits August 31, 2026 10:53
Signed-off-by: Nadine Spies <nadine.spies@solo.io>
…og docs

- Add kubernetes observability/access-logs section (view.md, export.md) with OTLP export via Policy CRD backendRef
- Add kubernetes observability/metrics section (control-plane-metrics.md, nacks.md)
- Add kubernetes observability/traces section (setup.md)
- Update observability/_index.md with navigation table
- Add redirects from old paths: security/access-logging, observability/tracing, observability/control-plane-metrics, observability/nacks
- Fix standalone access-logs/export.md: correct OTLP filter fallback behavior
- Fix standalone access-logs/database.md: add json_extract/->>'key' query examples for custom fields

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Nadine2016 <nadine.spies@solo.io>
Signed-off-by: Nadine2016 <nadine.spies@solo.io>
Signed-off-by: Nadine2016 <nadine.spies@solo.io>
Signed-off-by: Nadine2016 <nadine.spies@solo.io>
Signed-off-by: Nadine2016 <nadine.spies@solo.io>
Comment thread content/docs/kubernetes/latest/observability/_index.md Outdated
Comment thread content/docs/kubernetes/main/observability/otel-stack.md
Comment thread content/docs/kubernetes/latest/observability/_index.md Outdated
Comment thread assets/agw-docs/pages/observability/metrics/overview.md Outdated
Comment thread assets/agw-docs/pages/observability/traces/configs/honeycomb.md Outdated
Comment thread content/docs/kubernetes/latest/observability/otel-stack.md Outdated
Comment thread content/docs/kubernetes/latest/observability/traces/_index.md
Comment thread content/docs/kubernetes/latest/observability/access-logs/_index.md
Comment thread assets/agw-docs/pages/observability/control-plane-metrics.md Outdated
@Nadine2016
Nadine2016 merged commit f658b20 into main Sep 1, 2026
10 of 21 checks passed
@Nadine2016
Nadine2016 deleted the nadine/kubernetes-observability-restructure branch September 1, 2026 15:16
artberger added a commit that referenced this pull request Sep 1, 2026
…yout

main moved on while this branch was open — most substantially PR #990
("Observability updates for Kubernetes"), which restructured observability at
the PRE-docTabs paths, plus #998, #1006 and the timeout/agentcore edits.

Resolved by rule rather than by hand, because the two changes are orthogonal:
main's CONTENT wins for every file it touched, and this branch's LOCATION wins.
All 63 of main's content changes were re-applied at their docTabs path — for
these, `<version>/observability/…` becomes `<version>/documentation/observability/…`
— and this branch's transformations (the tab path prefix, the Integrations
regrouping, icon removal) were re-applied on top. Nothing of this branch's own
work is lost that way, because its edits to those files were only path rewrites
and icon removal.

The trap here is not the 30 conflicts, it is the files that merge CLEANLY. Most
of main's new observability pages had no counterpart on this branch, so git
happily added them at `<version>/observability/…` — a path that is outside every
tab in this layout, where they would render with no tab band and no nav. 35 such
duplicates were removed after their content was applied at the correct path.

Two files needed manual repair, both from git pairing a `latest` file of main's
against an ARCHIVED file of this branch by rename detection:
  - 1.3.x/documentation/observability/_index.md  (left conflict markers)
  - 1.3.x/documentation/observability/otel-stack.md  (mis-merged SILENTLY)
Both restored from this branch's side; main never touched 1.3.x. The silent one
was caught by diffing every archived version root against the pre-merge commit,
which is now the check to run after any merge into this branch — archived roots
must come out byte-identical.

Note the conflict markers were eight brackets deep, not seven, so a `^<<<<<<< `
grep misses them.

Verified: hugo builds clean, and an internal link check finds the same 44 dead
links as origin/main built at the same commit — no regressions. (Main itself went
from 23 to 44; the 21 new ones arrived with #990/#1006 and are not addressed
here.)

Signed-off-by: Art Berger <art.berger@solo.io>
kristin-kronstain-brown added a commit that referenced this pull request Sep 1, 2026
The rewrite in #990 renamed the heading to "Add and remove log fields"
but left two in-page links pointing at #add-and-remove-log-attributes.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Signed-off-by: Kristin Brown <kristin.brown@solo.io>
kristin-kronstain-brown added a commit that referenced this pull request Sep 1, 2026
The restructure in #990 deleted latest/security/access-logging and
main+latest/observability/tracing, but other pages still link to them.
Add stubs at the docTabs paths, matching the one #990 already left at
main/documentation/security/access-logging.

The tracing stubs set sidebar.exclude so a "Tracing" entry does not sit
beside the new "Traces" section.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Signed-off-by: Kristin Brown <kristin.brown@solo.io>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants