Uploaded image for project: 'Observability Documentation'
  1. Observability Documentation
  2. OBSDOCS-2754

Improve Loki Installation docs

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Unresolved
    • Icon: Undefined Undefined
    • None
    • Logging 6.0, Logging 6.1, Logging 6.2, Logging 6.3
    • Logging
    • False
    • Hide

      None

      Show
      None
    • False
    • Important

      URL

      https://docs.redhat.com/en/documentation/red_hat_openshift_logging/6.3/html/installing_logging/installing-logging#install-loki-operator-cli_installing-logging 

      ISSUE

      In the Loki installation should have

      1.   the Loki deployment sizing [0]. In fact, it should be in the "Prerequisites" [1] as it's needed to have available enough CPU + Memory + PVC + Object storage. Then, depending on the size, an OpenShift Admin should review if the nodes have enough resources available for it
      2.  it should be listed the different Object storages and their options. A good example for this is the tempo documentation [2] where in the tempo Installation part is documented how to set up the object storage and different parameters depending on the storage in a readable way. For logging it's in the "configuring section" explained, where it's supposed that I should have already configured 
      3. How to configure the CA. ODF requires CA, minio requires CA, Swift requires CA, but not mention how to do it in the Installation and when configuring. Those using an object storage that rquires CA, they fail. A bug for documenting how to set up the CA is already opened  [3]
      4. Loki example for when installing should have a retention policy set . Bug already opened [4] 

      All this above being missing in the Loki Installation leads to be not sucessful in the Loki installation.

       [0] https://docs.redhat.com/en/documentation/red_hat_openshift_logging/6.3/html/configuring_logging/configuring-lokistack-storage#loki-sizing_configuring-the-log-store
       [1] https://docs.redhat.com/en/documentation/red_hat_openshift_logging/6.3/html/installing_logging/installing-logging#prerequisites_cluster-logging-deploying_installing-logging 
       [2] https://docs.redhat.com/en/documentation/openshift_container_platform/4.16/html/distributed_tracing/distr-tracing-tempo-installing#distr-tracing-tempo-object-storage-setup_distr-tracing-tempo-installing 
       [3] https://issues.redhat.com/browse/OBSDOCS-2573 
       [4] https://issues.redhat.com/browse/OBSDOCS-2467

              Unassigned Unassigned
              rhn-support-ocasalsa Oscar Casal Sanchez
              Votes:
              1 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated: