143 Commits (c2f96221dcd89d41bbb119965e5fde2d21131b36)

Author	SHA1	Message	Date
Jack Baldry	8391e557b1	Update doc-validator to v3.0.0 (#9666) ... ## 3.0.0 ### Added - Structured output for use with [`reviewdog`](https://github.com/reviewdog/reviewdog). You can achieve the original error output by piping the output to the following `jq` expression: `jq -r '"ERROR: \(.location.path):\(.location.range.start.line):\(.location.range.start.column): \(.message)"'`. - Suggestions for simple link fixes. In GitHub, [`reviewdog`](https://github.com/reviewdog/reviewdog) comments these suggestions for convenient replacement. - Support for anchors referring to repeated headings. In the case that a page has multiple headings that share the same text, the renderer appends a zero indexed, numbered suffix to the identifier. For example, when there are two headings that are both "Heading text", the first anchor identifier is `heading-text` and the second is `heading-text-1`. - Error when running `doc-validator` on no files. **Notes for reviewer:** This also updates the `make-docs` procedure. Please ensure you can run `make docs` from the `docs/` directory before approving and merging this PR. --------- Signed-off-by: Jack Baldry <jack.baldry@grafana.com>	3 years ago
oleksii-boiko-ua	f9aba99455	Helm: add hpa for read, write and backend (#8684) ... **What this PR does / why we need it**: It adds missing HPA (HorizontalPodAutoscaler) templates to write, read, and backend components **Which issue(s) this PR fixes**: Fixes #7864 **Checklist** - [x] Reviewed the [`CONTRIBUTING.md`](https://github.com/grafana/loki/blob/main/CONTRIBUTING.md) guide (**required**) - [x] Documentation added - [ ] Tests updated - [x] `CHANGELOG.md` updated - [x] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md` Co-authored-by: Oleksii Boiko <oleksii_boiko@external.mckinsey.com>	3 years ago
Callum Styan	11f5218ebf	Add docs/migration guide for zone aware ingesters (#9290) ... This is migration guide is based on the internal migration guide we created when migrating our own environments to zone aware ingesters. We should probably structure some config documentation similar to https://grafana.com/docs/mimir/latest/operators-guide/configure/configure-zone-aware-replication/ as well --------- Signed-off-by: Callum Styan <callumstyan@gmail.com>	3 years ago
Fabien D	aff1f7e511	Update troubleshooting.md (#9112) ... **What this PR does / why we need it**: Fixes a small sentence in the documentation to document Loki tracing. **Which issue(s) this PR fixes**: None **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 - [x] Tests updated - [x] `CHANGELOG.md` updated - [x] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md`	3 years ago
J Stickler	1bb489c438	TOC Sync: Move LogQL and LogCLI files under Query. (#9200)	3 years ago
J Stickler	ce9e5353d3	TOC Sync: Move design docs, LIDs and maintaining under Community. (#9202) ... **What this PR does / why we need it**: **Which issue(s) this PR fixes**: Fixes #8720 **Special notes for your reviewer**: Part of the Database products table of contents alignment project. Moves Maintaining, Design Documents, and LID files under Community heading in TOC. Updates front matter for the topics. Adds aliases for redirects.	3 years ago
J Stickler	8ee9a2c3c7	TOC Sync: Move API docs under Reference. (#9203) ... **Which issue(s) this PR fixes**: Fixes #8719 **Special notes for your reviewer**: Part of the Database products table of contents alignment project. Moves API doc under Reference heading in TOC. Updates front matter for the topic. Fixes links broken by the move. Adds aliases for redirects.	3 years ago
Alain Pham	c1052d704c	Update retention doc tsdb support of compactor (#9397) ... compactor now also supports tsdb in addition to boltdb-schipper **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 - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md`	3 years ago
MattiasSegerdahl	7ec2482724	Update _index.md (#9308) ... **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 - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md`	3 years ago
Zirpolo	df5217baef	Change upper and lower case Compactor name (#9288) ... Made chances to reflect uniform reference to the name Compactor, changed all lowercase instance outside of code to uppercase. **What this PR does / why we need it**: To make the docs uniform when speaking about the Compactor **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 - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md`	3 years ago
MattiasSegerdahl	cb6cc7d878	Update recording-rules.md (#9324) ... **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 - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md`	3 years ago
Tulayb	86cbb43358	Update automatic-stream-sharding.md (#9317) ... **What this PR does / why we need it**: Fix typo on `automatic-stream-sharding.md`. **Which issue(s) this PR fixes**: N/A **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 - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md`	3 years ago
Christian Haudum	3ed54048a5	Docs: Add operational docs for query fairness within tenants (#8879) ... **What this PR does / why we need it**: This PR contains documentation how to make use of the newly added hierarchical scheduler queues. Signed-off-by: Christian Haudum <christian.haudum@gmail.com>	3 years ago
Karsten Jeschkies	cbc9c60b59	Give config snippets for automatic stream sharding. (#9098)	3 years ago
W.T. Chang	46e835fb3c	Docs: Replace mimir example config path with a loki one (#9125) ... **What this PR does / why we need it**: The example config path on Loki's query scheduler is using `-config.file=/mimir/config/mimir.yaml`, which looks a little bit confusing on Loki's document, even though there are multiple references to Mimir. 7bec727c6d/docs/sources/operations/scalability.md?plain=1#L23 This PR replaces the Mimir config path with the one found in query-frontend's document. 7bec727c6d/docs/sources/configuration/query-frontend.md?plain=1#L115 **Which issue(s) this PR fixes**: N/A **Special notes for your reviewer**: I noticed this when checking configuration of 2.6, but this is still the case in the [latest version](https://grafana.com/docs/loki/v2.8.x/operations/scalability/). **Checklist** - [X] Reviewed the [`CONTRIBUTING.md`](https://github.com/grafana/loki/blob/main/CONTRIBUTING.md) guide (**required**) - [ ] Documentation added - [ ] Tests updated - [ ] `CHANGELOG.md` updated - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md`	3 years ago
René Scheibe	e050d5c494	Docs: Update Loki GitHub URLs (#9080) ... * use `main` instead of `master` branch * fix outdated URLs	3 years ago
Erik Sjölund	2cccc1bc68	Docs: Fix typos and grammar (#8966) ... **What this PR does / why we need it**: Fixes typos and grammar. Most of them were occurrences of `it's` that should be `its`. **Which issue(s) this PR fixes**: None **Special notes for your reviewer**: **Checklist** - [x] Reviewed the [`CONTRIBUTING.md`](https://github.com/grafana/loki/blob/main/CONTRIBUTING.md) guide (**required**) - [ ] Documentation added - [ ] Tests updated - [ ] `CHANGELOG.md` updated - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md` Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>	3 years ago
Danny Kopping	6bb8a071ca	Querier: block query by hash (#8953) ... **What this PR does / why we need it**: Using the [query blocker](https://grafana.com/docs/loki/next/operations/blocking-queries/) can be unergonomic since queries can be long, require escaping, or hard to copy from logs. This change enables an operator to block queries by their hash.	3 years ago
Karsten Jeschkies	0030cafb16	Remove dedupe cache from operations documentation. (#8957)	3 years ago
Karsten Jeschkies	43ae1db14c	Give examples for all cache configurations. (#8832) ... **What this PR does / why we need it**: #8373 documented how to setup Memcached for caching. The documentation is missing some information on a few caches. These are added in this PR. **Checklist** - [ ] 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` --------- Co-authored-by: J Stickler <julie.stickler@grafana.com>	3 years ago
Athira Varghese	ffb961c439	feat(storage): add support for IBM cloud object storage as storage client (#8826) ... **What this PR does / why we need it**: Add support for IBM cloud object storage as storage client **Which issue(s) this PR fixes**: Fixes NA **Checklist** - [x] Reviewed the [`CONTRIBUTING.md`](https://github.com/grafana/loki/blob/main/CONTRIBUTING.md) guide (**required**) - [x] Documentation added - [x] Tests updated - [ ] `CHANGELOG.md` updated --------- Signed-off-by: Shahul <shahulsonhal@gmail.com> Co-authored-by: Aman Kumar Singh <amankrsingh2110@gmail.com> Co-authored-by: Suruthi-G-K <shruthi.suruthi@gmail.com> Co-authored-by: tareqmamari <tariq.mamari@de.ibm.com> Co-authored-by: shahulsonhal <shahulsonhal@gmail.com> Co-authored-by: Aditya C S <aditya.gnu@gmail.com> Co-authored-by: Tareq Al-Maamari <tariq.mamari@gmail.com>	3 years ago
Danny Kopping	528ed22dc2	Ruler: remote rule evaluation hardening (#8785) ... **What this PR does / why we need it**: This PR is part 2 of 2 implementing remote rule evaluation. See [part 1](https://github.com/grafana/loki/pull/8744) for more context.	3 years ago
J Stickler	858109046f	TOC Sync: Move grafana file under Visualize. (#8806) ... **Which issue(s) this PR fixes**: Fixes #8716 **Special notes for your reviewer**: Part of the Database products table of contents alignment project. Moves topic for Grafana dashboard from Operations to new Visualize heading in TOC. Updates front matter for the topic.	3 years ago
J Stickler	a99bbc9440	TOC Sync: Move alerting and recording rules under Alert. (#8805) ... **Which issue(s) this PR fixes**: Fixes #8717 **Special notes for your reviewer**: Part of the Database products table of contents alignment project. Moves alerting and recording rules from Rules to new Alert heading in TOC. Updates front matter for the topic. Fixes links broken by the move.	3 years ago
Danny Kopping	c15048b50b	Retention: add selector detail to docs (#8808) ... **What this PR does / why we need it**: This adds more detail around what can and cannot be used in a `selector` for retention. It was unclear whether arbitrary LogQL could be used or not; this makes it explicit. Also added some additional matchers to the examples to show that it can be combinatorial. --------- Signed-off-by: Danny Kopping <danny.kopping@grafana.com> Co-authored-by: J Stickler <julie.stickler@grafana.com>	3 years ago
Ed Welch	eadb9d2c00	Loki: Change the behavior of the 0 value for retention_period to disable retention. (#8753) ... **What this PR does / why we need it**: Issue #8359 exposed a very unfortunate inconsistency in a Loki config where the zero value did not disable a feature. By convention in Loki the zero value for a config typically "disables" it. This PR changes the retention_period to honor the zero value of `0` or `0s` to disable retention. **Which issue(s) this PR fixes**: Fixes #8359 **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 - [x] Tests updated - [x] `CHANGELOG.md` updated - [x] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md` --------- Signed-off-by: Edward Welch <edward.welch@grafana.com> Co-authored-by: J Stickler <julie.stickler@grafana.com>	3 years ago
J Stickler	5fbc747392	Fixing broken link and removing out of date blog post. (#8632) ... **Which issue(s) this PR fixes**: * Starts to address #8631 * Removes link to outdated blog post that says "Loki is very much alpha software and should not be used in production environments." * Fixes broken link to Configuration file.	3 years ago
Karsten Jeschkies	880de93093	Document memcached configuration for caching. (#8373) ... **What this PR does / why we need it**: Memcached is our default options for caching. However, the options for Memcached are not well documented. This change documents how Memcached should be configured and how Loki itself should be documented based on our ksonnet deployment. **Checklist** - [ ] 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` Co-authored-by: J Stickler <julie.stickler@grafana.com>	3 years ago
Danny Kopping	ebfeba5de3	Ruler: implement rule-based and shuffle sharding (#8092)	3 years ago
Travis Patterson	4b9cc39f9f	fix remaining docs issues (#8263)	3 years ago
Owen Diehl	8d3c50f40d	tsdb docs first pass (#8048) ... Co-authored-by: J Stickler <julie.stickler@grafana.com>	3 years ago
Travis Patterson	1c954166b8	Fix documentation linter errors (#8229)	3 years ago
Jijo Thomas John	54f09b89fd	[loki-canary] Support passing loki address as environment variable (#8205)	3 years ago
Travis Patterson	636e19dfeb	place canary docs in their own package and fix links+description (#8217) ... There is a PR blocked on incorrect canary docs: https://github.com/grafana/loki/pull/8205 This PR should clear that CI error so the author can rebase and have the PR accepted This was failing three lint checks: 1. Docs need a `description` header 2. Images have to link to the same directory so `./` instead of `../` 3. Images can only be linked from `_index.md` files so a new package is required	3 years ago
Yash Soni	c648968866	updating troubleshooting and upgrade changelog (#8206) ... **What this PR does / why we need it**: Updating docs which mentions `querier.query_timeout` to `limits_request.query_timeout` **Which issue(s) this PR fixes**: Fixes #8090 **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 - [x] `CHANGELOG.md` updated - [x] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md` Co-authored-by: Christian Haudum <christian.haudum@gmail.com>	3 years ago
JordanRushing	d8a0c6f87f	Revert "[loki-canary] Support passing loki address as environment variable (#8024)" (#8183) ... **What this PR does / why we need it**: This PR reverts commit f9ed9cb7d9 which introduced breaking config changes for the Loki canary. The relevant change introduced support for configuring a new `LOKI_ADDRESS` canary environment variable by adopting a new library for flags. This is the easiest path forward to avoid forcing breaking config changes on canary operators; such a change is likely better suited to join other configuration changes in a future major Loki release. **Which issue(s) this PR fixes**: N/A **Special notes for your reviewer**: Related PR: - https://github.com/grafana/loki/pull/8024 **Checklist** - [x] Reviewed the [`CONTRIBUTING.md`](https://github.com/grafana/loki/blob/main/CONTRIBUTING.md) guide (**required**) - [ ] Documentation added - [ ] Tests updated - [x] `CHANGELOG.md` updated - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md`	3 years ago
J Stickler	ca8fd8dfb7	[Docs] Remove outdated canary logo (#8035) ... Remove the rather outdated canary logo on the page describing the Loki canary app. https://grafana.com/docs/loki/latest/operations/loki-canary/ **Checklist** - [X] Reviewed the `CONTRIBUTING.md` guide - [X] Documentation added - [N/A] Tests updated - [ ] `CHANGELOG.md` updated - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md`	3 years ago
Travis Patterson	0db15efd50	Add stream sharding docs (#7901) ... This PR adds documentation for the new stream sharding feature. Co-authored-by: Steven Dungan <114922977+stevendungan@users.noreply.github.com>	3 years ago
Kim Nylander	4d97dc0cbb	[DOC] Fix broken links in docs (#8065) ... **What this PR does / why we need it**: This PR fixes several broken links in the Promtail, operations, and install sections of the doc.	3 years ago
Jijo Thomas John	f9ed9cb7d9	[loki-canary] Support passing loki address as environment variable (#8024) ... **What this PR does / why we need it**: - Replace flag with kingpin which has more capabilities to override defaults - Override default for `addr`, `user` and `pass` from environment the variables `LOKI_ADDRESS`, `LOKI_USERNAME` and `LOKI_PASSWORD` respectively. **Which issue(s) this PR fixes**: Fixes #8021 **Special notes for your reviewer**: **Checklist** - [x] Reviewed the `CONTRIBUTING.md` guide - [x] Documentation added - [ ] Tests updated - [x] `CHANGELOG.md` updated - [ ] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md`	3 years ago
Felix Ehrenpfort	8423f56537	fix small typo (#7874) ... This change fixes a small typo in case of a missing space.	3 years ago
Karsten Jeschkies	691b8be6c7	Provide Terraform script for setting up S3 and document role based access. (#7656) ... **What this PR does / why we need it**: Role based access to S3 on an EKS cluster via service account annotation was not documented well and let to some confusion. This change documents how a role based accessis achieved with providing an AWS secret access key and access key id. Thus there is no change of accidentally leaking credentials. A Terraform module is provided under `production/terraform/modules/s3` that provisions and S3 bucket and IAM role and policy. **Which issue(s) this PR fixes**: Fixes #7279 **Special notes for your reviewer**: **Checklist** - [ ] Reviewed the `CONTRIBUTING.md` guide - [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` Co-authored-by: Pablo Angulo <pablo.angulo@grafana.com>	3 years ago
Danny Kopping	a63ad06509	Querier/Ruler: query blocker (#7785) ... Block malicious or expensive queries using a per-tenant runtime configuration.	3 years ago
Marcelo Magallon	c2ef216df8	Mention default port in docs (#7637) ... I ran across a user setting up Loki and following this documentation, and they couldn't figure out the port where the HTTP server is listening for metrics requests. Be nice and mention the default here. Signed-off-by: Marcelo E. Magallon <marcelo.magallon@grafana.com>	3 years ago
Marcus Teixeira	0f131fe851	Docs: troubleshooting generation cache errors (#7600) ... Adds troubleshooting to generation cache(gennumber) errors. Ref: https://github.com/grafana/loki/pull/5661 Co-authored-by: Michel Hollands <42814411+MichelHollands@users.noreply.github.com>	3 years ago
Abder	cc9ba40be0	promtail: Fix exposed metric documentation for request_duration_seconds (#7420) ... **What this PR does / why we need it**: Fixing the documentation about exposed promtail metrics for promtail_request_duration_seconds **Which issue(s) this PR fixes**: No issue related **Special notes for your reviewer**: **Checklist** - [x] Reviewed the `CONTRIBUTING.md` guide - [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`	3 years ago
Karsten Jeschkies	85e524788e	Provide example policy for S3 storage. (#7407) ... **What this PR does / why we need it**: This should make it easier for users to set the proper policies for their S3 storage. **Which issue(s) this PR fixes**: Relates to #7403 **Special notes for your reviewer**: **Checklist** - [ ] Reviewed the `CONTRIBUTING.md` guide - [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`	3 years ago
Joel Verezhak	46d3dec010	[loki-canary] Allow insecure TLS connections (#7398) ... **What this PR does / why we need it**: This change allows client certificates signed by a self-signed certificate authority to be used by the Loki canary. **Which issue(s) this PR fixes**: Fixes #4366 **Special notes for your reviewer**: This has been tested on linux amd64 with self-signed certificates. **Checklist** - [x] Reviewed the `CONTRIBUTING.md` guide - [x] Documentation added - [x] Tests updated - [x] `CHANGELOG.md` updated - [x] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md`	3 years ago
Dennis Szczepanski	4e61c60296	Loki: Renames metric 'loki_log_messages_total' to 'loki_internal_log_messages_total' (#7361) ... **What this PR does / why we need it**: Renames the metric 'loki_log_messages_total' to a more descriptive name. Keeps and deprecates the previously existing metric to not break functionality. **Which issue(s) this PR fixes**: Fixes #7088 **Special notes for your reviewer**: **Checklist** - [x] Reviewed the `CONTRIBUTING.md` guide - [x] Documentation added - [x] Tests updated - [x] `CHANGELOG.md` updated - [x] Changes that require user attention or interaction to upgrade are documented in `docs/sources/upgrading/_index.md`	3 years ago
Garrett Guillotte	7eadddbcfc	Docs: Populate empty index pages (#7200) ... Three docs index pages are dead ends - they are either blank or have no links. In lieu of more detailed content, this PR populates these pages with `{{< section >}}` shortcodes that automatically generate TOC-like links to subpages.	3 years ago