diff --git a/logging/log_storage/cluster-logging-loki.adoc b/logging/log_storage/cluster-logging-loki.adoc index 14442e92c08e..d74c02b31e1e 100644 --- a/logging/log_storage/cluster-logging-loki.adoc +++ b/logging/log_storage/cluster-logging-loki.adoc @@ -50,6 +50,7 @@ endif::[] 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"] @@ -59,4 +60,4 @@ include::modules/loki-rate-limit-errors.adoc[leveloffset=+1] * link:https://loki-operator.dev/docs/howto_connect_grafana.md/[Grafana Dashboard documentation] * link:https://loki-operator.dev/docs/object_storage.md/[Loki Object Storage documentation] * link:https://loki-operator.dev/docs/api.md/#loki-grafana-com-v1-IngestionLimitSpec[{loki-op} `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 +# ... +---- +