This is a draft document that was built and uploaded automatically. It may document beta software and be incomplete or even incorrect. Use this document at your own risk.

Removing Log Data

Log data is stored in the Elasticsearch database. Elasticsearch stores the data in indices. One index per day is created for every OpenStack project.

By default, the indices are stored in the following directory on the host where the Monitoring Service is installed:

/var/data/elasticsearch/<cluster-name>/nodes/<node-name>

Example:

/var/data/elasticsearch/elasticsearch/nodes/0

Note

If your system uses a different directory, look up the path.data parameter in the Elasticsearch configuration file, /etc/elasticsearch/elasticsearch.yml.

If you want to delete outdated or unnecessary log data from the Elasticsearch database, proceed as follows:

  1. Make sure that curl is installed. If this is not the case, install the package with

    sudo zypper in curl
  2. Create a backup of the Elasticsearch database. For details, refer to the section called “Backup and Recovery”.

  3. Determine the ID of the OpenStack project for the data to be deleted:

    Log in to the OpenStack dashboard and go to Identity > Projects. The monasca project initially provides a ll metrics data related to SUSE OpenStack Cloud Monitoring.

    In the course of the productive operation of SUSE OpenStack Cloud Monitoring, additional projects may be created.

    The Project ID field shows the relevant ID.

  4. Log in to the host where the Monitoring Service is installed.

  5. Make sure that the data you want to delete exists by executing the following command:

    curl -XHEAD -i 'http://localhost:<port>/<projectID-date>'

    For example, if Elasticsearch is listening at port 9200 (default), the ID of the OpenStack project is abc123, and you want to check the index of 2015, July 1st, the command is as follows:

    curl -XHEAD -i 'http://localhost:9200/abc123-2015-07-01'

    If the HTTP response is 200, the index exists; if the response is 404, it does not exist.

  6. Delete the index as follows:

    curl -XDELETE -i 'http://localhost:<port>/<projectID-date>'

    Example:

    curl -XDELETE -i 'http://localhost:9200/abc123-2015-07-01'

    This command either returns an error, such as IndexMissingException, or acknowledges the successful deletion of the index.

Note

Be aware that the -XDELETE command immediately deletes the index file!

Both, for -XHEAD and -XDELETE, you can use wildcards for processing several indices. For example, you can delete all indices of a specific project for the whole month of July, 2015:

curl -XDELETE -i 'http://localhost:9200/abc123-2015-07-*'

Note

Take extreme care when using wildcards for the deletion of indices. You could delete all existing indices with one single command!