diff --git a/logging/log_storage/cluster-logging-loki.adoc b/logging/log_storage/cluster-logging-loki.adoc index 356faa3f8c01..7bab38536691 100644 --- a/logging/log_storage/cluster-logging-loki.adoc +++ b/logging/log_storage/cluster-logging-loki.adoc @@ -11,6 +11,7 @@ In {logging} documentation, _LokiStack_ refers to the {logging} supported combin include::modules/logging-creating-new-group-cluster-admin-user-role.adoc[leveloffset=+1] include::modules/logging-loki-retention.adoc[leveloffset=+1] include::modules/loki-rate-limit-errors.adoc[leveloffset=+1] +include::modules/logging-loki-memberlist-ip.adoc[leveloffset=+1] [role="_additional-resources"] [id="additional-resources_cluster-logging-loki"] @@ -19,4 +20,4 @@ include::modules/loki-rate-limit-errors.adoc[leveloffset=+1] * link:https://grafana.com/docs/loki/latest/logql/[Loki Query Language (LogQL) documentation] * link:https://loki-operator.dev/docs/howto_connect_grafana.md/[Grafana Dashboard documentation] //* link:https://loki-operator.dev/docs/api.md/#loki-grafana-com-v1-IngestionLimitSpec[Loki Operator `IngestionLimitSpec` documentation] -* link:https://grafana.com/docs/loki/latest/operations/storage/schema/#changing-the-schema[Loki Storage Schema documentation] +* link:https://grafana.com/docs/loki/latest/operations/storage/schema/#changing-the-schema[Loki Storage Schema documentation] \ No newline at end of file diff --git a/modules/logging-loki-memberlist-ip.adoc b/modules/logging-loki-memberlist-ip.adoc new file mode 100644 index 000000000000..4b31df4bbf05 --- /dev/null +++ b/modules/logging-loki-memberlist-ip.adoc @@ -0,0 +1,34 @@ +// Module included in the following assemblies: +// +// * logging/cluster-logging-loki.adoc + +:_mod-docs-content-type: CONCEPT +[id="logging-loki-memberlist-ip_{context}"] += Configuring Loki to tolerate memberlist creation failure + +In an OpenShift cluster, administrators generally use a non-private IP network range. As a result, the LokiStack memberlist configuration fails because, by default, it only uses private IP networks. + +As an administrator, you can select the pod network for the memberlist configuration. You can modify the LokiStack CR to use the `podIP` in the `hashRing` spec. To configure the LokiStack CR, use the following command: + +[source,terminal] +---- +$ oc patch LokiStack logging-loki -n openshift-logging --type=merge -p '{"spec": {"hashRing":{"memberlist":{"instanceAddrType":"podIP","type": "memberlist"}}}}' +---- + +.Example LokiStack to include `podIP` +[source,yaml] +---- +apiVersion: loki.grafana.com/v1 +kind: LokiStack +metadata: + name: logging-loki + namespace: openshift-logging +spec: +# ... + hashRing: + type: memberlist + memberlist: + instanceAddrType: podIP +# ... +---- +