accum
Description
For each event where field
is a number, the accum
command calculates a running total or sum of the numbers. The accumulated sum can be returned to either the same field, or a newfield
that you specify.
Syntax
accum <field> [AS <newfield>]
Required arguments
- field
- Syntax: <string>
- Description: The name of the field that you want to calculate the accumulated sum for. The field must contain numeric values.
Optional arguments
- newfield
- Syntax: <string>
- Description: The name of a new field where you want the results placed.
Basic example
1. Create a running total of a field
This example uses the sample data from the Search Tutorial but should work with any format of Apache web access log. To try this example on your own Splunk instance, you must download the sample data and follow the instructions to get the tutorial data into Splunk. Use the time range All time when you run the search. |
The following search looks for events from web access log files that were successful views of strategy games. A count of the events by each product ID is returned.
sourcetype=access_* status=200 categoryId=STRATEGY | chart count AS views by productId
The results appear on the Statistics tab and look something like this:
productId | views |
---|---|
DB-SG-G01 | 1796 |
DC-SG-G02 | 1642 |
FS-SG-G03 | 1482 |
PZ-SG-G05 | 1300 |
You can use the accum
command to generate a running total of the views and display the running total in a new field called "TotalViews".
sourcetype=access_* status=200 categoryId=STRATEGY | chart count AS views by productId | accum views as TotalViews
The results appear on the Statistics tab and look something like this:
productId | views | TotalViews |
---|---|---|
DB-SG-G01 | 1796 | 1796 |
DC-SG-G02 | 1642 | 3438 |
FS-SG-G03 | 1482 | 4920 |
PZ-SG-G05 | 1300 | 6220 |
See also
abstract | addcoltotals |
This documentation applies to the following versions of Splunk Cloud Platform™: 8.2.2112, 8.2.2201, 8.2.2202, 8.2.2203, 9.0.2205, 9.0.2208, 9.0.2209, 9.0.2303, 9.0.2305, 9.1.2308, 9.1.2312, 9.2.2403, 9.2.2406 (latest FedRAMP release)
Feedback submitted, thanks!