Splunk product terminology
Splunk docs use standard terms and definitions for Splunk software, certain combinations of Splunk software, and parts of Splunk product architecture. When used alone, "Splunk" refers only to the company, not to any product. Don't use "Splunk" in the possessive form.
Follow these usage guidelines to choose the correct term when you write about Splunk software.
The Splunk platform and Splunk software
Use the Splunk platform to refer collectively to Splunk Cloud and Splunk Enterprise. Don't capitalize the "p" in "platform", and make sure you include a definite article.
- The Splunk platform
- the Splunk platform
- The Splunk Platform
- Splunk platform
Use Splunk software to refer to anything and everything the company offers. Don't capitalize the "s" in "software", and don't include a definite article.
- Splunk software
- The Splunk software
- The Splunk Software
- the Splunk Software
- Splunk Software
You can use "the Splunk platform" as a modifier. Avoid using "Splunk" as a modifier by itself when you are referring to a specific instance where the Splunk platform is installed, Splunk platform deployments, or the environment in which the Splunk platform is running.
- Restart the Splunk platform instance...
- In a distributed Splunk platform deployment...
- In your Splunk platform environment...
- Splunk platform server
- Splunk server
- Splunk deployment
- Splunk instance
- Splunk environment
- Splunk implementation
Choose the most specific and accurate term in each situation
When considering what noun to use when referring to a Splunk product, always use the most specific and accurate term that is appropriate for the situation. For example, you can refer to a product using a specific node or service of the product, such as a search head or deployment server. If you need a more general term, refer to the product by its product name, such as Splunk Enterprise or Splunk Cloud, or its product category, such as the Splunk platform. If you must refer to both a platform product and an app, you can use the most general term, "Splunk software". The following diagram shows the level of specificity for Splunk product terms:
Use these guidelines to determine which term to write:
- If you're thinking about using Splunk Enterprise or Splunk Cloud, consider whether a specific node of the product, like the search head, the indexer cluster, Splunk Web, the data collection node, the deployment server, the forwarder, and so on, is more helpful for customers.
- When you are referring to a specific platform product, name it.
- When you are referring to an app, name the app or write "the app".
- When you are referring to Splunk Cloud or Splunk Enterprise but you don't know which product the user has, write "the Splunk platform". This is common.
- Use "Splunk software" only when you are referring to one or more platform products plus one or more apps, or when either a core product or an app could be the subject. This is the rarest case.
Here are examples of Splunk product terms in a sentence with an explanation of why the term in bold is the best term to use:
|Configure your inputs on your data collection node using the inputs.conf file or Splunk Web.||The most specific and accurate term here is the node on which the configuration takes place.|
|The performance of this application is dependent on a variety of factors, including the other Splunk apps that you have installed on the same search head.||Because this sentence is about search head performance, the node (search head) is the most specific and accurate term in this situation. Also, "Splunk apps" is the most specific and accurate term rather than "Splunk software" because because apps and not the core product are what users can install on a search head.|
|This manual discusses high-level hardware guidance for Splunk Enterprise deployments and describes how Splunk Enterprise uses hardware resources in different situations.||The Capacity Planning Manual applies only to Splunk Enterprise, so you can be specific and name the product.|
|The Splunk Datasets Add-on, available from Splunkbase, gives Splunk Enterprise users additional dataset management capabilities. Splunk Cloud users have the Splunk Datasets Add-on by default. ... In previous versions of the Splunk platform, data model datasets were called data model objects.||The initial entry point for this feature is different in Splunk Enterprise and Splunk Cloud, so the writer makes that clear up front by using the product names. For the remainder of the documentation, "the Splunk platform" is appropriate because it includes both Splunk Enterprise and Splunk Cloud.|
|Metrics is a feature of the Splunk platform.||The metrics feature is available for Splunk Cloud and Splunk Enterprise, so the Metrics manual uses "the Splunk platform" to be inclusive of all platform types.|
|Splunk IT Service Intelligence uses the access control system integrated with the Splunk platform.||You don't know whether the customer is administering ITSI on Splunk Enterprise or Splunk Cloud, so use "the Splunk platform" here to be inclusive of both.|
|Splunk Education offers a variety of courses and certification programs to help make you more productive with Splunk software.||Splunk Education courses cover some premium apps as well as core product offerings, so using "Splunk software" is appropriate here.|
|If you have questions about the licenses that apply to the Splunk software you are using, contact Splunk Support.||Some apps also have separate licenses and entitlements, so this more general term is appropriate here.|
Still not sure which term to use?
Try these steps:
- First, try to name the specific node or product. If that level of precision is appropriate, use that term.
- If the specific node or product name isn't appropriate, try using "the Splunk platform". When you use "the Splunk platform" in the sentence, can you replace it with at least one of the following things and have the sentence still make sense?
- "Splunk Enterprise or Splunk Cloud"
- "your forwarder or your single-instance deployment"
- If "the Splunk platform" doesn't make sense, try using "Splunk software". When you use "Splunk software" in the sentence, can you replace it with at least one of the following things and have the sentence still make sense?
- "the Splunk platform or a Splunk app"
- "the Splunk platform or Splunk apps"
- "the Splunk platform or some Splunk apps"
- "Splunk Enterprise or Splunk apps"
- "Splunk Enterprise or some Splunk apps"
- "Splunk Cloud or cloud-supported Splunk apps"
Splunk Web terminology
This documentation applies to the following versions of Splunk® Style Guide: current