Migrate Elasticsearch to OpenSearch

Author: MoteHue

source/operations_and_monitoring.rst

@@ -4,22 +4,22 @@
 Operations and Monitoring
 =========================
 
-Access to Kibana
-================
+Access to OpenSearch Dashboards
+===============================
 
 OpenStack control plane logs are aggregated from all servers by Fluentd and
-stored in ElasticSearch. The control plane logs can be accessed from
-ElasticSearch using Kibana, which is available at the following URL:
-|kibana_url|
+stored in OpenSearch. The control plane logs can be accessed from
+OpenSearch using OpenSearch Dashboards, which is available at the following URL:
+|opensearch_dashboards_url|
 
-To log in, use the ``kibana`` user. The password is auto-generated by
+To log in, use the ``opensearch`` user. The password is auto-generated by
 Kolla-Ansible and can be extracted from the encrypted passwords file
 (|kolla_passwords|):
 
 .. code-block:: console
    :substitutions:
 
-   kayobe# ansible-vault view ${KAYOBE_CONFIG_PATH}/kolla/passwords.yml --vault-password-file |vault_password_file_path| | grep ^kibana
+   kayobe# ansible-vault view ${KAYOBE_CONFIG_PATH}/kolla/passwords.yml --vault-password-file |vault_password_file_path| | grep ^opensearch_dashboards
 
 Access to Grafana
 =================
@@ -293,7 +293,7 @@ Monitoring
 ----------
 
 * `Back up InfluxDB <https://docs.influxdata.com/influxdb/v1.8/administration/backup_and_restore/>`__
-* `Back up ElasticSearch <https://www.elastic.co/guide/en/elasticsearch/reference/current/backup-cluster-data.html>`__
+* `Back up OpenSearch <https://opensearch.org/docs/latest/tuning-your-cluster/availability-and-recovery/snapshots/snapshot-restore/>`__
 * `Back up Prometheus <https://prometheus.io/docs/prometheus/latest/querying/api/#snapshot>`__
 
 Seed
@@ -309,8 +309,8 @@ Ansible control host
 Control Plane Monitoring
 ========================
 
-The control plane has been configured to collect logs centrally using the EFK
-stack (Elasticsearch, Fluentd and Kibana).
+The control plane has been configured to collect logs centrally using the FOOD
+stack (Fluentd, OpenSearch and OpenSearch Dashboards).
 
 Telemetry monitoring of the control plane is performed by Prometheus. Metrics
 are collected by Prometheus exporters, which are either running on all hosts
@@ -508,7 +508,8 @@ Overview
 * Remove the node from maintenance mode in bifrost
 * Bifrost should automatically power on the node via IPMI
 * Check that all docker containers are running
-* Check Kibana for any messages with log level ERROR or equivalent
+* Check OpenSearch Dashboards for any messages with log level ERROR or
+  equivalent
 
 Controllers
 -----------
@@ -647,28 +648,25 @@ perform the following cleanup procedure regularly:
             fi
           done
 
-Elasticsearch indexes retention
+OpenSearch indexes retention
 ===============================
 
-To enable and alter default rotation values for Elasticsearch Curator, edit
+To alter default rotation values for OpenSearch, edit
 ``${KAYOBE_CONFIG_PATH}/kolla/globals.yml``:
 
 .. code-block:: console
 
-   # Allow Elasticsearch Curator to apply a retention policy to logs
-   enable_elasticsearch_curator: true
-
-   # Duration after which index is closed
-   elasticsearch_curator_soft_retention_period_days: 90
+   # Duration after which index is closed (default 30)
+   opensearch_soft_retention_period_days: 90
 
-   # Duration after which index is deleted
-   elasticsearch_curator_hard_retention_period_days: 180
+   # Duration after which index is deleted (default 60)
+   opensearch_hard_retention_period_days: 180
 
-Reconfigure Elasticsearch with new values:
+Reconfigure Opensearch with new values:
 
 .. code-block:: console
 
-   kayobe overcloud service reconfigure --kolla-tags elasticsearch
+   kayobe overcloud service reconfigure --kolla-tags opensearch
 
 For more information see the `upstream documentation
-<https://docs.openstack.org/kolla-ansible/latest/reference/logging-and-monitoring/central-logging-guide.html#curator>`__.
+<https://docs.openstack.org/kolla-ansible/latest/reference/logging-and-monitoring/central-logging-guide.html#applying-log-retention-policies>`__.

source/vars.rst

@@ -25,7 +25,7 @@
 .. |kayobe_source_url| replace:: https://github.com/acme-openstack/kayobe.git
 .. |kayobe_source_version| replace:: ``acme/yoga``
 .. |keystone_public_url| replace:: https://openstack.acme.example:5000
-.. |kibana_url| replace:: https://openstack.acme.example:5601
+.. |opensearch_dashboards_url| replace:: https://openstack.acme.example:5601
 .. |kolla_passwords| replace:: https://github.com/acme-openstack/kayobe-config/blob/acme/yoga/etc/kayobe/kolla/passwords.yml
 .. |monitoring_host| replace:: ``mon0``
 .. |network_name| replace:: admin-vxlan