Troubleshooting

This section collects common installation or usage problems on the Wazuh app, and some basic steps to solve them.

“Incorrect Kibana version in plugin [wazuh]” when installing the app

The Wazuh app has a file named package.json, it includes dependencies along more information. One of them is the Kibana version:

"kibana": {
    "version": "6.4.0"
},

Your app must match the installed Kibana version. If the version field in the package.json file is 6.4.0 then your installed Kibana version must be 6.4.0.

You can check our Compatibility matrix to learn more about product compatibility between Wazuh and the Elastic Stack.

No template found for the selected index pattern

Elasticsearch needs a specific template to store Wazuh alerts, otherwise visualizations won’t load properly. You can insert the correct template using the following command:

# curl https://raw.githubusercontent.com/wazuh/wazuh/3.6/extensions/elasticsearch/wazuh-elastic6-template-alerts.json | curl -XPUT 'http://localhost:9200/_template/wazuh' -H 'Content-Type: application/json' -d @-

Warning

Indices with the wrong template will need to be reindexed. You can follow our reindexation guide.

Wazuh API seems to be down

It means your Wazuh API could be unavailable. Since the Wazuh app needs data from the Wazuh API, it must be available for the Wazuh app.

If you are using systemd, please check the status as follow:

# systemctl status wazuh-api

If you are using SysV Init, please check the status as follow:

# service wazuh-api status

If the Wazuh API is running, try to fetch data using the CLI from the Kibana server:

# curl api_user:api_pass@api_url:55000/version

If the curl command fails but the Wazuh API is running properly, it means you have a connectivity problem between servers.

I don’t see alerts in the Wazuh app

The first step is to check if there are alerts in Elasticsearch.

# curl <ELASTICSEARCH_IP>:9200/_cat/indices/wazuh-alerts-3.x-*

If you don’t see any Wazuh related index, it means you have no alerts stored in Elasticsearch.

  1. If you are using a single-host architecture, check if Logstash is reading the alerts.json file:
# lsof /var/ossec/logs/alerts/alerts.json

There should be two processes reading the alerts.json file: ossec-analysisd and java.

  1. If you are using a distributed architecture, check if Filebeat is reading the alerts.json file:
# lsof /var/ossec/logs/alerts/alerts.json

There should be two processes reading the alerts.json file: ossec-analysisd and filebeat.

API version mismatch. Expected vx.y.z

The Wazuh app uses the Wazuh API to fetch information, being compatible between patch versions. For example, you can use an app designed for Wazuh 3.6.1 with a Wazuh API 3.6.0.

You can’t use the 3.5.0 version of Wazuh API with a Wazuh app designed for Wazuh 3.6.1.

Check our Compatibility matrix to learn more about compatibility between the API and the app.

Routes. Error. Cannot read property ‘manager’ of undefined

This error usually means that you’re using Wazuh v2.x with Elastic Stack v6.x, or Wazuh v3.x with Elastic Stack v5.x.

You have to use the correct versions of Wazuh and the Elastic Stack to work properly. We always recommend upgrading to the latest version following this guide.

None of the above solutions are fixing my problem

All the technologies we are using have their own logs files, you can check them and look for error and warning messages.

  1. Check the Elastic Stack log files:
# cat /var/log/elasticsearch/elasticsearch.log | grep -i -E "error|warn"
# cat /var/log/filebeat/filebeat | grep -i -E "error|warn"
# cat /var/log/logstash/logstash-plain.log | grep -i -E "error|warn"
  1. Check the Wazuh app log file:
# cat /usr/share/kibana/plugins/wazuh-logs/wazuhapp.log | grep -i -E "error|warn"
  1. Check the Wazuh Manager log file:
# cat /var/ossec/logs/ossec.log | grep -i -E "error|warn"

You can also open a new thread in our Google mailing list, or a new issue in our GitHub repository.