About license violations

About license violations

This topic discusses license violations, how they come about, and how to resolve them. Before you proceed, you may want to review these topics:

• Read "How Splunk licensing works" in this manual for an introduction to Splunk licensing.
• Read "Groups, stacks, pools, and other terminology" in this manual for more information about Splunk license terms.

What are license violations and warnings?

Violations occur when you exceed the maximum indexing volume allowed for your license. If you exceed your licensed daily volume on any one calendar day, you will get a violation warning. The message persists for 14 days. If you have 5 or more warnings on an Enterprise license or 3 warnings on a Free license in a rolling 30-day period, you are in violation of your license and search will be disabled. Search capabilities return when you have fewer than 5 (Enterprise) or 3 (Free) warnings in the previous 30 days, or when you apply a temporary reset license (available for Enterprise only). To obtain a reset license, contact your sales rep. The license comes with instructions on how to apply it.

Note: Summary indexing volume is not counted against your license.

If you get a violation warning, you have until midnight (going by the time on the license master) to resolve it before it counts against the total number of warnings within the rolling 30-day period.

During a license violation period:

• Splunk does not stop indexing your data. Splunk only blocks search while you exceed your license.
• Searches to the _internal index are not disabled. This means that you can still access the Indexing Status dashboard or run searches against _internal to diagnose the licensing problem.

What license warnings look like

If indexers in a pool exceed the license volume allocated to that pool, you will see a yellow warning banner across the top of Splunk Web:

Clicking on the link in the banner takes you to Manager > Licensing, where the warning shows up under the Alerts section of the page. Click on a warning to get more information about it.

A similar banner is shown on license slaves when a violation has occurred.

Here are some of the conditions that will generate a licensing alert:

• When a slave becomes an orphan, there will be an alert (transient and fixable before midnight)
• When a pool has maxed out, there will be an alert (transient and fixable before midnight)
• When a stack has maxed out, there will be an alert (transient and fixable before midnight)
• When a warning is given to one or more slaves, there will be an alert (will stay as long as the warning is still valid within that last 30-day period)

About the connection between the license master and license slaves

When a license master instance is configured, and license slaves are added to it, the license slaves communicate their usage to the license master every minute. If the license master is unreachable for any reason, the license slave starts a 24-hour timer. If the license slave cannot reach the license master for 24 hours, search is blocked on the license slave (although indexing continues). Users will not be able to search data in the indexes on the license slave until that slave can reach the license master again.

To find out if a license slave has been unable to reach the license master, look for an event that contains failed to transfer rows in splunkd.log or search for it in the _internal index.

How to avoid license violations

To avoid license violations, monitor your license usage and ensure you have sufficient license volume to support it. If you do not have sufficient license volume, you need to either increase your license or decrease your indexing volume.

Here are a couple of options for monitoring license usage:

• Use the deployment monitor app's license usage tab to see how licensing capacity is used in your deployment. Check out the "View license usage" section of "Manage your licenses" in this manual for more information.
• Use the "Indexing volume" status dashboard in the Search app to see details about index volume in your infrastructure.

Access the Indexing volume status dashboard

To see the "Indexing volume" dashboard:

1. Log into Splunk Web and navigate to the Search app.

2. Click Status > Index activity > Indexing volume.

3. Choose a server, "split-by" option (to see indexing volume by source, source type, index, or host), and a time range. The dashboard will reload automatically and update your results.

4. To drill down into more detail, click on a row in the list. From there, you can view the events on a timeline. To view the events themselves, click on a bar in the timeline:

Troubleshoot license violations

Take a look at this Community Wiki topic to troubleshoot.

Answers

Have questions? Visit Splunk Answers and see what questions and answers the Splunk community has around license violations.

• Was this topic useful?
• Post a comment