diff --git a/modules/log6x-quickstart-opentelemetry.adoc b/modules/log6x-quickstart-opentelemetry.adoc index e30926549c..460aeff72f 100644 --- a/modules/log6x-quickstart-opentelemetry.adoc +++ b/modules/log6x-quickstart-opentelemetry.adoc @@ -12,11 +12,13 @@ include::snippets/technology-preview.adoc[] To configure OTLP ingestion and enable the OpenTelemetry data model, follow these steps: .Prerequisites -* Cluster administrator permissions +* You have access to an {product-title} cluster with `cluster-admin` permissions. +* You have installed the {oc-first}. +* You have access to a supported object store. For example, AWS S3, Google Cloud Storage, {azure-short}, Swift, Minio, or {rh-storage}. .Procedure -. Install the {clo}, {loki-op}, and {coo-first} from OperatorHub. +. Install the `{clo}`, `{loki-op}`, and `{coo-first}` from OperatorHub. . Create a `LokiStack` custom resource (CR) in the `openshift-logging` namespace: + @@ -58,7 +60,7 @@ $ oc create sa collector -n openshift-logging + [source,terminal] ---- -$ oc adm policy add-cluster-role-to-user logging-collector-logs-writer -z collector +$ oc adm policy add-cluster-role-to-user logging-collector-logs-writer -z collector -n openshift-logging ---- + [NOTE] @@ -66,26 +68,21 @@ $ oc adm policy add-cluster-role-to-user logging-collector-logs-writer -z collec The `ClusterRole` resource is created automatically during the Cluster Logging Operator installation and does not need to be created manually. ==== -. Allow the collector's service account to collect logs: +. To collect logs, use the service account of the collector by running the following commands: + [source,terminal] ---- -$ oc project openshift-logging +$ oc adm policy add-cluster-role-to-user collect-application-logs -z collector -n openshift-logging ---- + [source,terminal] ---- -$ oc adm policy add-cluster-role-to-user collect-application-logs -z collector +$ oc adm policy add-cluster-role-to-user collect-audit-logs -z collector -n openshift-logging ---- + [source,terminal] ---- -$ oc adm policy add-cluster-role-to-user collect-audit-logs -z collector ----- -+ -[source,terminal] ----- -$ oc adm policy add-cluster-role-to-user collect-infrastructure-logs -z collector +$ oc adm policy add-cluster-role-to-user collect-infrastructure-logs -z collector -n openshift-logging ---- + [NOTE] @@ -155,4 +152,6 @@ You cannot use `lokiStack.labelKeys` when `dataModel` is `Otel`. To achieve simi ==== .Verification -* Verify that OTLP is functioning correctly by going to *Observe* -> *OpenShift Logging* -> *LokiStack* -> *Writes* in the OpenShift web console, and checking *Distributor - Structured Metadata*. \ No newline at end of file +* To verify that OTLP is functioning correctly, complete the following steps: +.. In the OpenShift web console, click *Observe* -> *OpenShift Logging* -> *LokiStack* -> *Writes*. +.. Check the *Distributor - Structured Metadata* section.