apitech/loki - loki - Gitea: Git with a cup of tea

Commit Graph

Author	SHA1	Message	Date
J Stickler	4d38ff7935	docs: Update structured metadata docs (#12187 )	2 years ago
J Stickler	0ac42e78c2	docs: restore links, update procedure in Quick Start (#12068 ) Co-authored-by: Jack Baldry <jack.baldry@grafana.com>	2 years ago
J Stickler	6e4a9f3bdd	docs: Restore link to flog (#12011 ) Co-authored-by: Trevor Whitney <trevorjwhitney@gmail.com>	2 years ago
J Stickler	46c6118eb2	Update docs to support OTEL GA (#11858 ) What this PR does / why we need it: Updating the docs in advance of OTEL release to remove "experimental" notes. Also restructured release notes so that most recent content is first.	2 years ago
Steven Dungan	8289ca7188	Structured metadata docs update (#11843 ) * Rewrote description to highlight primary use case * Added defaults for how much structured metadata can be added to log lines * Rewrote example queries What this PR does / why we need it: Which issue(s) this PR fixes: Fixes #<issue number> Special notes for your reviewer: Checklist - [ ] Reviewed the [`CONTRIBUTING.md`](https://github.com/grafana/loki/blob/main/CONTRIBUTING.md) guide (required) - [ ] Documentation added - [ ] Tests updated - [ ] `CHANGELOG.md` updated - [ ] If the change is worth mentioning in the release notes, add `add-to-release-notes` label - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/setup/upgrade/_index.md` - [ ] For Helm chart changes bump the Helm chart version in `production/helm/loki/Chart.yaml` and update `production/helm/loki/CHANGELOG.md` and `production/helm/loki/README.md`. [Example PR](`d10549e3ec`) - [ ] If the change is deprecating or removing a configuration option, update the `deprecated-config.yaml` and `deleted-config.yaml` files respectively in the `tools/deprecated-config-checker` directory. [Example PR](`0d4416a4b0`)	2 years ago
George Wilson	1002ba00df	Note the helm chart and docs do not agree (#11782 ) What this PR does / why we need it: Docs do not match the code in the helm chart - where the read deployment is made as a statefulset with ReadWriteOnce disks (https://github.com/grafana/loki/blob/main/production/helm/loki/templates/read/statefulset-read.yaml). I suspect the docs are correct that it's possible - but given it's the official helm chart - the deviation should be noted. Which issue(s) this PR fixes: N/A Special notes for your reviewer: Checklist - [x] Reviewed the [`CONTRIBUTING.md`](https://github.com/grafana/loki/blob/main/CONTRIBUTING.md) guide (required) - [x] Documentation added - [ ] Tests updated - [ ] `CHANGELOG.md` updated - [ ] If the change is worth mentioning in the release notes, add `add-to-release-notes` label - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/setup/upgrade/_index.md` - [ ] For Helm chart changes bump the Helm chart version in `production/helm/loki/Chart.yaml` and update `production/helm/loki/CHANGELOG.md` and `production/helm/loki/README.md`. [Example PR](`d10549e3ec`) - [ ] If the change is deprecating or removing a configuration option, update the `deprecated-config.yaml` and `deleted-config.yaml` files respectively in the `tools/deprecated-config-checker` directory. [Example PR](`0d4416a4b0`) --------- Co-authored-by: J Stickler <julie.stickler@grafana.com>	2 years ago
J Stickler	0dc8c75331	Update admonitions to add shortcode (#11622 ) What this PR does / why we need it: Completing the work that was started in #9409 but not completed because there were multiple variations on how to format notes in the docs source files. We rolled out different colors for admonitions recently, which highlighted that there were still a few notes not using the admonition shortcode. I searched the docs for the following words: * tip * caution * important * warning * note So hopefully I've caught all of the admonitions that weren't using the shortcode.	2 years ago
Edson C	20d1fa641d	Docs: Add a note about Loki labels format (#11597 ) What this PR does / why we need it: Which issue(s) this PR fixes: Fixes #9928 Special notes for your reviewer: This PR adds a note about an important requirement in the format of Loki labels (with a small example). Checklist - [x] Reviewed the [`CONTRIBUTING.md`](https://github.com/grafana/loki/blob/main/CONTRIBUTING.md) guide (required) - [ ] Documentation added - [ ] Tests updated - [ ] `CHANGELOG.md` updated - [ ] If the change is worth mentioning in the release notes, add `add-to-release-notes` label - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/setup/upgrade/_index.md` - [ ] For Helm chart changes bump the Helm chart version in `production/helm/loki/Chart.yaml` and update `production/helm/loki/CHANGELOG.md` and `production/helm/loki/README.md`. [Example PR](`d10549e3ec`) - [ ] If the change is deprecating or removing a configuration option, update the `deprecated-config.yaml` and `deleted-config.yaml` files respectively in the `tools/deprecated-config-checker` directory. [Example PR](`0d4416a4b0`) --------- Co-authored-by: Michel Hollands <42814411+MichelHollands@users.noreply.github.com> Co-authored-by: J Stickler <julie.stickler@grafana.com>	2 years ago
J Stickler	efdea22db4	Update descriptions (#11586 ) What this PR does / why we need it: Updates the `description` field in the metadata to support the Docs Landing Page project --------- Co-authored-by: Michel Hollands <42814411+MichelHollands@users.noreply.github.com>	2 years ago
Alejandro	aa0d706db6	Fix the structured-metadata docs page (#11518 ) What this PR does / why we need it: This little typo may confuse somebody if they would copy/paste the example. Checklist - [x] Reviewed the [`CONTRIBUTING.md`](https://github.com/grafana/loki/blob/main/CONTRIBUTING.md) guide (required) - [ ] Documentation added - [ ] Tests updated - [ ] `CHANGELOG.md` updated - [ ] If the change is worth mentioning in the release notes, add `add-to-release-notes` label - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/setup/upgrade/_index.md` - [ ] For Helm chart changes bump the Helm chart version in `production/helm/loki/Chart.yaml` and update `production/helm/loki/CHANGELOG.md` and `production/helm/loki/README.md`. [Example PR](`d10549e3ec`) - [ ] If the change is deprecating or removing a configuration option, update the `deprecated-config.yaml` and `deleted-config.yaml` files respectively in the `tools/deprecated-config-checker` directory. [Example PR](`0d4416a4b0`) Co-authored-by: Michel Hollands <42814411+MichelHollands@users.noreply.github.com>	2 years ago
J Stickler	6b4d27c955	fix image links in getting started (#11478 ) Fixes two image links as images aren't showing up from previous PR (#11350). https://grafana.com/docs/loki/next/get-started/quick-start/ should display a graphic and a screenshot of Grafana Explore, but only the captions are visible.	2 years ago
J Stickler	4614950064	Update Getting Started topic and graphics (#11350 ) What this PR does / why we need it: Which issue(s) this PR fixes: Final PR to complete fixes #9228 Special notes for your reviewer: Updates Getting Started topic to be a general overview, links to Grafana topics, and Agent configuration file. Adds new Quick Start topic for running Loki Docker compose file locally that includes working sample queries. Adds three new graphics Removes two unused graphics	2 years ago
J Stickler	7c4882a99f	Add note about use of object storage (#11443 ) PR #9031 from @Alex3k has gone quite stale as the topic has been revised since it was submitted. This PR attempts to get at least part of Alex's update into the documentation so that we can close his original PR.	2 years ago
J Stickler	bc9a00695e	Update structured metadata note (#11399 ) Update the note on the Structured Metadata page now that it is available on Cloud.	2 years ago
fostec82	32f1ec2fda	feat(logstash): clients logstash output structured metadata support (#10899 ) What this PR does / why we need it: This PR adds support for Loki Structured Metadata to the logstash output plugin. Special notes for your reviewer: Given that Structure Metadata is enabled as an experimental feature plugin changes were done in a way that is backward compatible for users not wanted structured metadata. Co-authored-by: Jared King <kingjs@gmail.com> Co-authored-by: J Stickler <julie.stickler@grafana.com>	2 years ago
J Stickler	4d61d0a901	[Style] Data source as two words. (#11124 ) What this PR does / why we need it: Updating "datasource" to be "data source" per recent decision by Style Council.	2 years ago
J Stickler	54937784f9	Revert scalable monolithic to SSD (#10958 ) After consultation with @stevendungan, reverting the terminology "Scalable monolithic deployment" back to "Simple scalable deployment." Decided to add a note about the confusion that SSD causes to clarify that we don't mean solid state drives. FYI @monodot --------- Co-authored-by: Michel Hollands <42814411+MichelHollands@users.noreply.github.com>	2 years ago
J Stickler	7ee1cff8c7	Fixing 404s (#10921 ) Fixes several broken cross-references. Which issue(s) this PR fixes: Fixes #10867	2 years ago
Ashwanth	695c5b0f83	chore: update examples, docs to use the latest loki version (#10925 ) What this PR does / why we need it: - run ./tools/release_update_tags.sh to use v2.9.2 - also updates the release security patch docs to include version upgrade step Which issue(s) this PR fixes: Fixes #<issue number> Special notes for your reviewer: Checklist - [ ] Reviewed the [`CONTRIBUTING.md`](https://github.com/grafana/loki/blob/main/CONTRIBUTING.md) guide (required) - [ ] Documentation added - [ ] Tests updated - [ ] `CHANGELOG.md` updated - [ ] If the change is worth mentioning in the release notes, add `add-to-release-notes` label - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/setup/upgrade/_index.md` - [ ] For Helm chart changes bump the Helm chart version in `production/helm/loki/Chart.yaml` and update `production/helm/loki/CHANGELOG.md` and `production/helm/loki/README.md`. [Example PR](`d10549e3ec`)	2 years ago
J Stickler	ba95f80e5a	Fix graphic link in Deployment Modes topic (#10778 ) Linked to the same graphic twice by accident. Fixing the link to point to the correct graphic file.	2 years ago
J Stickler	f0f3557ce2	Update headings in deployment modes topic (#10745 ) I realized when I was looking at this topic, that the headings were not parallel. ![Headings](https://github.com/grafana/loki/assets/4106682/d8847f91-06a7-4929-8d63-d704ffa6ebda) Fixed the headings, and also updated the first paragraphs to include the words "deployment mode" since I took it out of the headings.	2 years ago
J Stickler	bb92837afe	[docs] Update deployment modes topic and graphics (#10589 ) What this PR does / why we need it: Revising/Refreshing the Deployment modes as second phase of addressing #9228. Updates the three graphics: Monolithic mode diagram simplified to emphasize that this mode is for smaller deployments. Scalable Monolithic mode diagram now includes backend target. Microservices mode diagram now includes Compactor, Index Gateway, and Query Scheduler. Which issue(s) this PR fixes: Also fixes #9765 (missing backend target) and fixes #8754.	2 years ago
iTrooz	f4ab1e3e89	Doc: Fix link typos in documentation (#10722 ) What this PR does / why we need it: On https://grafana.com/docs/loki/latest/get-started/overview/ you can see that two links do not render well. I fixed them in this PR. Checklist - [x] Reviewed the [`CONTRIBUTING.md`](https://github.com/grafana/loki/blob/main/CONTRIBUTING.md) guide (required) - [ ] Documentation added - [ ] Tests updated - [ ] `CHANGELOG.md` updated - [ ] If the change is worth mentioning in the release notes, add `add-to-release-notes` label - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/setup/upgrade/_index.md` - [ ] For Helm chart changes bump the Helm chart version in `production/helm/loki/Chart.yaml` and update `production/helm/loki/CHANGELOG.md` and `production/helm/loki/README.md`. [Example PR](`d10549e3ec`) --------- Co-authored-by: J Stickler <julie.stickler@grafana.com>	2 years ago
Vladyslav Diachenko	bd63f371ec	Update structured-metadata docs (#10698 ) OSS users tried to use the structured metadata feature and faced an issue because they used previous schema versions (V11, V12) and they were not aware that it was necessary to use V13 because the docs did not cover it. re: https://github.com/grafana/loki/issues/10683	2 years ago
Christian Haudum	a3b9534f37	Restructure API reference documentation (#10654 ) * Removed unsupported APIs * Change order so it matches the list on top * Write better headings * Make cURL examples consistent with command-response-blocks Signed-off-by: Christian Haudum <christian.haudum@gmail.com>	2 years ago
Christian Haudum	b353251e47	Docs: Revise components page (#10666 ) What this PR does / why we need it: The page was lacking information about components and also did not contain components that were added already a long time ago. Checklist - [x] Reviewed the [`CONTRIBUTING.md`](https://github.com/grafana/loki/blob/main/CONTRIBUTING.md) guide (required) - [x] Documentation added - [ ] Tests updated - [ ] `CHANGELOG.md` updated - [ ] If the change is worth mentioning in the release notes, add `add-to-release-notes` label - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/setup/upgrade/_index.md` - [ ] For Helm chart changes bump the Helm chart version in `production/helm/loki/Chart.yaml` and update `production/helm/loki/CHANGELOG.md` and `production/helm/loki/README.md`. [Example PR](`d10549e3ec`) --------- Signed-off-by: Christian Haudum <christian.haudum@gmail.com>	2 years ago
Christian Haudum	2d7930e6d8	Revise documentation about Loki architecture (#10672 ) Also split out legacy storage into separate page. Signed-off-by: Christian Haudum <christian.haudum@gmail.com>	2 years ago
J Stickler	aed39c89ee	[docs] Replace ampersand with the word "and" (#10637 ) Replacing the ampersand character (&) with the word `and` to conform to the Style Guide https://grafana.com/docs/writers-toolkit/write/style-guide/capitalization-punctuation/#punctuation-guidelines Do not abbreviate and with an ampersand (&).	2 years ago
J Stickler	29c7ead5ed	[Docs] Revise Loki Overview topic (#10457 ) What this PR does / why we need it: Revising/Refreshing the Loki overview as first phase of addressing #9228.	2 years ago
J Stickler	dbfd81b868	Fix broken redirect (#10510 ) Fix a broken alias that is generating 404 errors	2 years ago
Jack Baldry	b5aae6985c	Fix alias to redirect `/docs/loki/<LOKI_VERSION>/best-practices/` to `/docs/loki/latest/get-started/labels/bp-labels/` (#10506 ) Tested locally with `make docs` Signed-off-by: Jack Baldry <jack.baldry@grafana.com> Signed-off-by: Jack Baldry <jack.baldry@grafana.com>	2 years ago
J Stickler	71d526a23a	[Style updates] Capitalize Loki when referring to project. (#10462 ) What this PR does / why we need it: Went through and looked for places where Loki should be capitalized because we are talking about the product or project (vs. in configuration examples, etc. where lower case is acceptable or required).	2 years ago
J Stickler	bf530fc64b	[Docs] Update warning on structured metadata topic (#10459 )	2 years ago
Vladyslav Diachenko	00a3c5b026	renamed `non indexed labels` feature to `structured metadata` (#10432 ) Loki team has made a decision to rename the feature because the new name is more precise. --------- Signed-off-by: Vladyslav Diachenko <vlad.diachenko@grafana.com> Co-authored-by: Salva Corts <salva.corts@grafana.com>	2 years ago
Salva Corts	603eb637f6	Add docs for non-indexed labels (#10073 ) What this PR does / why we need it: Adds documentation for the new experimental non-indexed labels feature. --------- Co-authored-by: J Stickler <julie.stickler@grafana.com> Co-authored-by: Sandeep Sukhani <sandeep.d.sukhani@gmail.com> Co-authored-by: Vladyslav Diachenko <82767850+vlad-diachenko@users.noreply.github.com>	2 years ago
willcramer	7f48efb60a	Update labels.md (#10124 ) What this PR does / why we need it: - Reworded some phrasing to achieve a more formal tone - Corrected some grammatical errors - Modified sentence structure for improved readability - Removed extra blank lines and made a pass at ensuring uniformity through the document	2 years ago
J Stickler	d0545bff2d	[docs] Create top level Send data section, part 2 (#10247 ) Part of the database information architecture Epic # 8710 Which issue(s) this PR fixes: Second half of work for issue # 8741 that was started in PR #10192 When closed, fixes #8741 Move the following files under Send data: ./sources/clients/promtail/_index.md ./sources/clients/promtail/configuration.md ./sources/clients/promtail/gcplog-cloud.md ./sources/clients/promtail/installation.md ./sources/clients/promtail/logrotation/_index.md ./sources/clients/promtail/pipelines.md ./sources/clients/promtail/scraping.md ./sources/clients/promtail/stages/_index.md ./sources/clients/promtail/stages/cri.md ./sources/clients/promtail/stages/decolorize.md ./sources/clients/promtail/stages/docker.md ./sources/clients/promtail/stages/drop.md ./sources/clients/promtail/stages/json.md ./sources/clients/promtail/stages/labelallow.md ./sources/clients/promtail/stages/labeldrop.md ./sources/clients/promtail/stages/labels.md ./sources/clients/promtail/stages/limit.md ./sources/clients/promtail/stages/logfmt.md ./sources/clients/promtail/stages/match.md ./sources/clients/promtail/stages/metrics.md ./sources/clients/promtail/stages/multiline.md ./sources/clients/promtail/stages/output.md ./sources/clients/promtail/stages/pack.md ./sources/clients/promtail/stages/regex.md ./sources/clients/promtail/stages/replace.md ./sources/clients/promtail/stages/static_labels.md ./sources/clients/promtail/stages/template.md ./sources/clients/promtail/stages/tenant.md ./sources/clients/promtail/stages/timestamp.md ./sources/clients/promtail/troubleshooting/_index.md This PR also - Revises the Clients landing page to clarify supported clients. - Updates the metadata (descriptions, weights) - Adds aliases to redirect from the old URLs. - Updates cross-references broken by the move/renaming. - A few other small fixes (headings, typos, etc.) Special notes for your reviewer: Please review the updates to the Clients landing page (now called Send Data) as I've made some extensive edits to try to clarify recommended/supported clients. The file is docs/sources/send-data/_index.md --------- Co-authored-by: Michel Hollands <42814411+MichelHollands@users.noreply.github.com>	2 years ago
J Stickler	cc2aeac860	Break up and move Best Practices topic. (#9912 ) I realized that I should have moved the Best Practices topic as part of #8711, since most of the content is best practices for using labels. This PR: * Splits the file into two parts (Best practices for labels and best practices for configuration) * Moves the two files to Get Started and Configure, respectively. * Updates page weights for both sections as needed.	2 years ago
J Stickler	8e59fcac91	Update redirects to use new alias format. (part 2 of 2) (#9890 ) Breaking the alias updates into two PRs to make for smaller reviews. Special notes for your reviewer: @jdbaldry commented on #9717 that the alias format had changed, but we [agreed](https://github.com/grafana/loki/pull/9717#issuecomment-1594960563) that I could update it in a follow up PR. This is that follow up. Also updating previously merged file moves that used the old alias format. <strike>I could not get relative redirects to work for the LIDS or Maintaining files, so had to use the older format, which did work.</strike> Updated weights for some pages. Updated a couple of `menuTitles` that I missed updating on previous PRs. --------- Co-authored-by: Jack Baldry <jack.baldry@grafana.com>	2 years ago
J Stickler	b3b4317861	Fix image links in moved files. (#9910 ) Noticed the other day that images in files that have been moved as part of #8710 were not displaying in `/next/`. This PR updates the image references.	2 years ago
J Stickler	1c9160bc4b	Remove aliases to current location. (#9911 ) Re: [this comment ](https://github.com/grafana/loki/pull/9890#pullrequestreview-1521562982)from @jdbaldry on #9890 that "Relative aliases that refer to the current page location won't be effective and should be removed because they can cause confusion and might result in mistaken redirects in the future if pages are moved again." Removing aliases that refer to the current location of the pages.	2 years ago
Jara Suárez de Puga García	10e38b8b74	Request to change the loki-overview-2 image (#9359 ) What this PR does / why we need it: We in support are doing some review of public documents in general, the Overview is okay but the image seemed quite outdated, I was wondering if it would be nice to have it updated to this or something else ( not sure if it is the correct format). Checklist - [x] Reviewed the [`CONTRIBUTING.md`](https://github.com/grafana/loki/blob/main/CONTRIBUTING.md) guide (required) - [x] Documentation added - [ ] Tests updated - [ ] `CHANGELOG.md` updated - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md`	2 years ago
J Stickler	0d79b219b2	Update redirects to use new alias format. (part 1 of 2) (#9881 ) Special notes for your reviewer: @jdbaldry commented on #9717 that the alias format had changed, but we [agreed](https://github.com/grafana/loki/pull/9717#issuecomment-1594960563) that I could update it in a follow up PR. This is that follow up. Also updating previously merged file moves that used the old alias format. Breaking the alias updates into two PRs to make for smaller reviews.	2 years ago
J Stickler	7797a98074	TOC Sync: Move configuration files under Configure (#9879 ) Which issue(s) this PR fixes: Fixes #8713 Special notes for your reviewer: Replaces PR [#8817](https://github.com/grafana/loki/pull/8817), which was stale and badly out of date. Part of the Database products table of contents alignment project. Moves configuration files from Configuration to new Configure heading in TOC. Updates front matter for the topic. Fixes links broken by the move. Updates the MakeFile to point to the new Configure DOCS_SOURCES_PATH.	2 years ago
David Peleg	c129cfe93c	Docs: add reference to flog CLI args (#9638 ) What this PR does / why we need it: Which issue(s) this PR fixes: Fixes #<issue number> Special notes for your reviewer: Checklist - [x] Reviewed the [`CONTRIBUTING.md`](https://github.com/grafana/loki/blob/main/CONTRIBUTING.md) guide (required) - [x] Documentation added - [ ] Tests updated - [ ] `CHANGELOG.md` updated - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md` - [ ] For Helm chart changes bump the Helm chart version in `production/helm/loki/Chart.yaml` and update `production/helm/loki/CHANGELOG.md` and `production/helm/loki/README.md`. [Example PR](`d10549e3ec`)	2 years ago
J Stickler	32320736db	TOC Sync: Move files under Get Started. (#9717 ) Which issue(s) this PR fixes: Fixes #8711 Special notes for your reviewer: Part of the Database products table of contents alignment project. Moves Getting Started and Fundamentals files under Get Started in TOC. Updates front matter for the topic (headings, page weights, descriptions, aliases to redirect from old URL to new URL) Fixes links broken by the move.	3 years ago

46 Commits (36e3d7ea61b77d88ea63a8e237fd013043f0411b)