Splunk® Style Guide

Splunk Style Guide

Acrobat logo Download manual as PDF


The guidelines in the Splunk Style Guide establish best practices for writing technical documentation. Search docs.splunk.com to find documentation related to Splunk products.
Acrobat logo Download topic as PDF

Splunk product terminology

Splunk docs use standard terms and definitions for Splunk software, certain combinations of Splunk software, and parts of Splunk product architecture. Follow these usage guidelines to choose the correct term when you write about Splunk software.

As a best practice, 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. Refer to the following table for examples of terms you can choose from:

Type of term Examples
Component or service Search head

Deployment server

Product name Splunk Enterprise

Splunk Cloud Platform
Splunk Application Performance Monitoring
Splunk Add-on for Unix and Linux

Product category The Splunk platform

Splunk Observability Cloud
Apps and add-ons

A combination of Splunk products and categories Splunk software

Splunk terminology reference

The following table compiles the basic definitions and examples for commonly used terms in the Splunk lexicon. For extended definitions and guidance, refer to the rest of the topic.

Term Definition Guidance Examples
Splunk When used alone, refers only to the company, not to any product. See Splunk by itself. Splunk customer

Splunk has a mascot named Buttercup.

Splunk software Refers to any combination of Splunk Enterprise, Splunk Cloud Platform, any Splunk-supported apps and add-ons, and any other software produced by Splunk. See Splunk software. Splunk software extracts different kinds of knowledge from your data.
The Splunk platform Refers to both Splunk Enterprise and Splunk Cloud Platform. See The Splunk platform. Restart the Splunk platform.

Each Splunk platform instance requires a license.

Splunk Observability Cloud Refers to the cloud-only product suite that is separate from the Splunk platform product offerings. See Splunk Observability Cloud. Splunk Observability Cloud provides transparent usage data with detailed reports on all monitored hosts, containers, and metrics.

Splunk by itself

When used alone, "Splunk" refers only to the company, not to any product. When using the word "Splunk", follow these conventions:

  • Don't use "Splunk" in the possessive form, which can dilute the trademark. See Trademark attribution.
  • Don't use "Splunk" as a noun if you want to describe a product.
  • Don't use "Splunk" as a verb to describe an action.
  • 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. See The Splunk platform.

The following examples are correct uses of "Splunk" by itself because they refer to the company and not to a specific product:

  • A Splunk customer
  • Splunk has a mascot named Buttercup.

Review the following table for examples of how to rewrite sentences that have the incorrect usage of "Splunk":

Do this Don't do this
Configure Splunk software. Configure your Splunk.
Restart the Splunk platform. Restart Splunk.
Run the Splunk universal forwarder. Run Splunk's universal forwarder.
Run the Splunk platform on your data. Splunk your data.
Access your Splunk instance. Access your Splunk platform instance.

Splunk software

Use "Splunk software" to refer to anything and everything the company offers. Use this term only when you are referring to a Splunk platform product and an app, or when either a Splunk platform product or an app can be the subject. Otherwise, aim to choose the most specific term for your situation.

When using the term "Splunk software", follow these conventions:

  • Don't capitalize the "s" in "software".
  • Don't include a definite article.
  • Don't use "Splunk software" in the possessive form, which can dilute the trademark. See Trademark attribution.

Review the following table for examples of correct usage:

Do this Don't do this
Splunk software Splunk Software

The Splunk software

Splunk software processing properties Splunk software's processing properties

The Splunk platform

Use "the Splunk platform" to refer to both Splunk Enterprise and Splunk Cloud Platform. You can use "the Splunk platform" either as a noun or as a modifier.

Before you use a general term like the Splunk platform, consider whether a specific component 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. See Splunk platform architecture components.

As a noun

When using "the Splunk platform" as a noun, follow these conventions:

  • Include a definite article.
  • Don't capitalize the "p" in "platform".
  • Don't use "the Splunk platform" in the possessive form, which can dilute the trademark. See Trademark attributions.

Review the following table for examples of correct usage:

Do this Don't do this
the Splunk platform The Splunk Platform

Splunk platform

the searching capabilities of the Splunk platform the Splunk platform's searching capabilities

As a modifier

You can use "the Splunk platform" or "Splunk platform" without a definite article 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.

Review the following table for examples of correct usage:

Do this Don't do this
Restart the Splunk platform instance... Restart the Splunk instance…
In a distributed Splunk platform deployment... In a distributed Splunk deployment…
In your Splunk platform environment... In your Splunk environment…

Splunk platform architecture components

Don't capitalize Splunk platform architecture components such as indexers, forwarders, search heads, license managers, and deployment servers. If you are unsure how to capitalize a Splunk term, see the Splexicon for the correct capitalization.

Splunk Observability Cloud

Splunk Observability Cloud is a cloud-only product suite that is separate from the Splunk platform product offerings.

When referring to this offering, follow these conventions:

  • Don't omit "Splunk" to shorten the name.
  • Don't use an acronym, such as SOC, to refer to this offering.
  • Don't use the definite article "the" in front of the product name.
  • Don't refer to this offering as a "platform".
  • Don't use "Splunk Observability Cloud" in the possessive form, which can dilute the trademark. See Trademark attribution.

Review the following table for examples of correct usage:

Do this Don't do this
Splunk Observability Cloud SOC

Observability Cloud
the Splunk Observability Cloud
the Splunk Observability Cloud platform

features of Splunk Observability Cloud Splunk Observability Cloud's features
Last modified on 24 January, 2024
PREVIOUS
Slashes
  NEXT
Splunk Web terminology

This documentation applies to the following versions of Splunk® Style Guide: current


Was this documentation topic helpful?


You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters