Skip to content

Add the LGTM stack and Integrations overview pages - #416

Merged
rasheedamir merged 6 commits into
mainfrom
docs/lgtm-stack
Aug 13, 2026
Merged

Add the LGTM stack and Integrations overview pages#416
rasheedamir merged 6 commits into
mainfrom
docs/lgtm-stack

Conversation

@aayeshaarshad

@aayeshaarshad aayeshaarshad commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Adds two pages to the Integrations section, and the nav entries for both.

The LGTM stack page

content/integrations/lgtm/lgtm.md documents multi-tenant observability across
the whole stack: how telemetry is collected per tenant, and what enforces the
tenant boundary in front of each component. It complements the Grafana
integration page rather than repeating it — Grafana's own surface
(organisations, data sources, dashboards, sign-in) is linked, not restated.

Structure: what a tenant gets, what you do not have to configure per tenant,
how it works (architecture diagram, ingestion, what settles the tenant), what
the stack is made of, and what can be tailored.

Claims were checked against the upstream docs and our repositories:

  • Loki, Mimir and Tempo each read the tenant from X-Scope-OrgID and none
    authenticates it; all three upstream docs direct you to an authenticating
    reverse proxy and make that proxy responsible for setting the header.
  • Gateway behaviour, route sets and header handling come from the
    mto-loki-gateway and mto-mimir-gateway READMEs and middleware.
  • Prometheus remote-write headers are static per block, so a cluster-wide
    Prometheus needs a block per tenant; the Template Operator renders those
    from the Tenant list.
  • Deployment routes verified per component: Loki and the collector have both
    operator and chart; Grafana publishes no Mimir operator; Grafana must come
    from the Grafana Operator; Tempo's authenticating gateway is the operator's,
    the chart's nginx gateway only does basic auth.

The Integrations overview page

content/integrations/overview.md came in via #417, which was merged into this
branch rather than into main. This PR is therefore what carries it to main.
It is the section index, and it links the LGTM page, so the two belong together.

Note: that page lists six integrations but omits OpenBao, which is now in the
nav — it was written before #413 landed.

Checks

Vale passes on both pages. The nav lists overview, ArgoCD, Grafana, LGTM,
Vault, OpenBao, DevWorkspace and Mattermost.

@aayeshaarshad
aayeshaarshad requested a review from a team as a code owner August 13, 2026 11:32
@github-actions

github-actions Bot commented Aug 13, 2026

Copy link
Copy Markdown

@stakater-user Image is available for testing. docker pull ghcr.io/stakater/mto-docs:v0.0.343

@github-actions

Copy link
Copy Markdown

@aayeshaarshad Image is available for testing. docker pull ghcr.io/stakater/mto-docs:SNAPSHOT-PR-416-b44f9dc3

@msafwankarim msafwankarim added the screenshots-captured To ensure the screenshots capture flow does not run on push-to-main label Aug 13, 2026
@github-actions

Copy link
Copy Markdown

@aayeshaarshad PR doc deploy will soon be available for review on https://stakater.github.io/mto-docs/docs-lgtm-stack

@github-actions

Copy link
Copy Markdown

@aayeshaarshad Image is available for testing. docker pull ghcr.io/stakater/mto-docs:SNAPSHOT-PR-416-ccb77f1e

@github-actions

Copy link
Copy Markdown

@aayeshaarshad PR doc deploy will soon be available for review on https://stakater.github.io/mto-docs/docs-lgtm-stack

Comment thread content/integrations/lgtm/lgtm.md
Comment thread content/integrations/lgtm/lgtm.md
@github-actions

Copy link
Copy Markdown

@aayeshaarshad Image is available for testing. docker pull ghcr.io/stakater/mto-docs:SNAPSHOT-PR-416-d2e7a3e3

@aayeshaarshad aayeshaarshad changed the title Add the LGTM stack integration page Add the LGTM stack and Integrations overview pages Aug 13, 2026
@rasheedamir
rasheedamir merged commit 3faf0f3 into main Aug 13, 2026
12 checks passed
@rasheedamir
rasheedamir deleted the docs/lgtm-stack branch August 13, 2026 19:56
@github-actions

Copy link
Copy Markdown

@rasheedamir PR doc deploy was successfully deleted from branch pull-request-deployments

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

screenshots-captured To ensure the screenshots capture flow does not run on push-to-main

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants