OBSDOCS-339 Configuring Loki to tolerate membership creation failure

Author: shreyasiddhartha

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]

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
+# ...
+----
+