WARNING: Version 5.0 of the Elastic Stack has passed its EOL date.
This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.
License Expiration
editLicense Expiration
editLicense expiration should never be a surprise. If you’re using Monitoring, a license expiration warning is displayed prominently if your license expires within 30 days. Warnings are also displayed on startup and written to the Elasticsearch log starting 30 days from the expiration date. These error messages tell you when the license expires and what features will be disabled if you fail to update it.
# License [will expire] on [Friday, December 30, 2016]. If you have a new license, please update it. # Otherwise, please reach out to your support contact. # # Commercial plugins operate with reduced functionality on license expiration: # - security # - Cluster health, cluster stats and indices stats operations are blocked # - All data operations (read and write) continue to work # - watcher # - PUT / GET watch APIs are disabled, DELETE watch API continues to work # - Watches execute and write to the history # - The actions of the watches don't execute # - monitoring # - The agent will stop collecting cluster and indices metrics # - The agent will stop automatically cleaning indices older than [xpack.monitoring.history.duration] # - graph # - Graph explore APIs are disabled
Once the license expires, calls to the cluster health, cluster stats, and index stats APIs
fail with a security_exception
and return a 403 HTTP status code.
{ "error": { "root_cause": [ { "type": "security_exception", "reason": "current license is non-compliant for [security]", "license.expired.feature": "security" } ], "type": "security_exception", "reason": "current license is non-compliant for [security]", "license.expired.feature": "security" }, "status": 403 }
This enables automatic monitoring systems to easily detect the license failure without immediately impacting other users.
You should update your license as soon as possible. You’re essentially flying blind when running with an expired license. Access to the cluster health and stats APIs is critical for monitoring and managing an Elasticsearch cluster.