|
| 1 | +// Module included in the following assemblies: |
| 2 | +//cluster-logging-release-notes.adoc |
| 3 | + |
| 4 | +:_content-type: PROCEDURE |
| 5 | +[id="cluster-logging-loki-tech-preview_{context}"] |
| 6 | +:FeatureName: Loki Operator |
| 7 | +include::snippets/technology-preview.adoc[] |
| 8 | + |
| 9 | +[id="cluster-logging-about-loki"] |
| 10 | += About Loki |
| 11 | + |
| 12 | +Loki is a horizontally scalable, highly available, multi-tenant log aggregation system currently offered as an alternative to Elasticsearch as a log store for the {logging}. |
| 13 | + |
| 14 | +[role="_additional-resources"] |
| 15 | +.Additional resources |
| 16 | +* link:https://grafana.com/docs/loki/latest/[Loki Documentation] |
| 17 | + |
| 18 | +== Deploying the Lokistack |
| 19 | +You can use the {product-title} web console to install the LokiOperator. |
| 20 | + |
| 21 | +.Prerequisites |
| 22 | + |
| 23 | +* {product-title}: 4.10 |
| 24 | +* {logging-title-uc}: 5.4 |
| 25 | + |
| 26 | +To install the LokiOperator using the {product-title} web console: |
| 27 | + |
| 28 | +. Install the LokiOperator: |
| 29 | + |
| 30 | +.. In the {product-title} web console, click *Operators* -> *OperatorHub*. |
| 31 | + |
| 32 | +.. Choose *LokiOperator* from the list of available Operators, and click *Install*. |
| 33 | + |
| 34 | +.. Under *Installation Mode*, select *All namespaces on the cluster*. |
| 35 | + |
| 36 | +.. Under *Installed Namespace*, select *openshift-operators-redhat*. |
| 37 | ++ |
| 38 | +You must specify the `openshift-operators-redhat` namespace. The `openshift-operators` |
| 39 | +namespace might contain Community Operators, which are untrusted and could publish |
| 40 | +a metric with the same name as an {product-title} metric, which would cause |
| 41 | +conflicts. |
| 42 | + |
| 43 | +.. Select *Enable operator recommended cluster monitoring on this namespace*. |
| 44 | ++ |
| 45 | +This option sets the `openshift.io/cluster-monitoring: "true"` label in the Namespace object. |
| 46 | +You must select this option to ensure that cluster monitoring |
| 47 | +scrapes the `openshift-operators-redhat` namespace. |
| 48 | + |
| 49 | +.. Select an *Approval Strategy*. |
| 50 | ++ |
| 51 | +* The *Automatic* strategy allows Operator Lifecycle Manager (OLM) to automatically update the Operator when a new version is available. |
| 52 | ++ |
| 53 | +* The *Manual* strategy requires a user with appropriate credentials to approve the Operator update. |
| 54 | + |
| 55 | +.. Click *Install*. |
| 56 | + |
| 57 | +.. Verify that you installed the LokiOperator. Visit the *Operators* → *Installed Operators* page and look for "LokiOperator." |
| 58 | + |
| 59 | +.. Ensure that *LokiOperator* is listed in all the projects whose *Status* is *Succeeded*. |
0 commit comments