icon/x Created with Sketch.

Splunk Cookie Policy

We use our own and third-party cookies to provide you with a great online experience. We also use these cookies to improve our products and services, support our marketing campaigns, and advertise to you on our website and other websites. Some cookies may continue to collect information after you have left our website. Learn more (including how to update your settings) here.
Accept Cookie Policy

We are working on something new...

A Fresh New Splunkbase
We are designing a New Splunkbase to improve search and discoverability of apps. Check out our new and improved features like Categories and Collections. New Splunkbase is currently in preview mode, as it is under active development. We welcome you to navigate New Splunkbase and give us feedback.

Accept License Agreements

This app is provided by a third party and your right to use the app is in accordance with the license provided by that third-party licensor. Splunk is not responsible for any third-party apps and does not provide any warranty or support. If you have any questions, complaints or claims with respect to this app, please contact the licensor directly.

Thank You

Downloading Timewrap
SHA256 checksum (timewrap_24.tgz) 87ca9e8908ba4711f3092c733070caac7207e493c20fa83ee2f46d947ed78937 SHA256 checksum (timewrap_23.tgz) e2b321b0cc8296fcba3233d398864d4d1c1777c18948d273e59b8aec5a1de255 SHA256 checksum (timewrap_22.tgz) 5370173d99d3c97a25009fba01cc41acd253fa2e027af2f1887d3794d7b98e2a SHA256 checksum (timewrap_21.tgz) 8f7cf33daae6142790d8442ea39690393d81385ea1c97170c347ced31417896b SHA256 checksum (timewrap_19.tgz) bf3a55a7904ab4ffcc48ece14544deb87ee6711a195482f9e5aba4b40acca3ee SHA256 checksum (timewrap_18.tgz) 7f00ffd99c01f461edb0cbfdc4a14bed8505f18f8b2a93000f9aa5e5288a25fe SHA256 checksum (timewrap_17.tgz) 47963c0b26efaccca2b8a706c06c566558d32f68d173920a7ca7127aa5d447f8 SHA256 checksum (timewrap_16.tgz) 6447a9f9052a7d3647bb5e8a11280c45f829c12ccfae7d6b18a3c5a3dadcb390 SHA256 checksum (timewrap_15.tgz) fea4ce32b5a1312a59852d9ad33b9ce81e225f2e7acaa0fb7f8d4a009acf7f21 SHA256 checksum (timewrap_14.tgz) 3200e07c978a61464b91bf2b0fb405197ded870d19be778218752c23fde085af SHA256 checksum (timewrap_13.tgz) 28f704ba3e06dfe3c1a484b6a00dd1b0e1982314d989f6e4a5319615b96a8c56 SHA256 checksum (timewrap_12.tgz) a1b86b718463baaa4e5b894db0febce3942ec04fd039be405bba6004d45252e3 SHA256 checksum (timewrap_11.tgz) a489e2c77d1c404c63a2e5b2ac4eccbc224a7b86746ede5b04d121535b89aebb
To install your download
For instructions specific to your download, click the Details tab after closing this window.

Flag As Inappropriate

splunk

Timewrap

Splunk Cloud
This app has been archived. Learn more about app archiving.
This app is NOT supported by Splunk. Please read about what that means for you here.
Overview
Details
This small app gives you a new, convenient search command called "timewrap" that does it all, for arbitrary time periods. Compare week-over-week, day-over-day, month-over-month, quarter-over-quarter, year-over-year, or any multiple (e.g. two week periods over two week periods).

Just add "| timewrap w" after a 'timechart' command, and compare week-over-week. Or use 'h' (hour), 'w' (week), 'm' (month), 'q' (quarter), 'y' (year).

Beginning in version 6.5.0, the Timewrap command in this app is included in the Splunk search processing language: http://docs.splunk.com/Documentation/Splunk/latest/SearchReference/Timewrap

"THIS IS AWESOME!"
"Now I don't need to twist my brain to get the week vs week graphs right."
"Cool thanks. Playing with timewrap now! Cool tool, especially for noobs"

David Carasso, Splunk’s Chief Mind, wrote this and many other apps, as well as the book Exploring Splunk. We still miss him http://blogs.splunk.com/2015/01/30/remembering-david/.

FAQ

Q: I'm searching last week, how come my weekly results seem to start on Monday?

A: This is not an error. Timewap relies on the timeframe of the search. You are searching for a 7 day window FROM sunday. That's mon,tues,wed,thurs,fri,sat,sun. If you want to start on Sunday, end your search on Saturday @w-1.

Q: I searched for day over day for a week, but I get 8 lines charted. Why not 7?

A: If you are searching last seven 24 hour periods, which will occur on 8 days, unless you start at midnight. If snap to the start of a day, this will go away.

Q: How can I compare Wednesdays to Wednesdays?

A: Do your search as usual, and filter at the end (filtering up-front will confuse timechart):

.... | timechart count span=1h | timewrap w | where strftime(_time, "%A") == "Wednesday"

Q: How can I change the names of the series?

A: There is now a new "series" option to determines the naming convention of the series names:

  • "relative" gives values like "latest_week", "1week_ago", "2weeks_ago", etc.;
  • "short" gives short span names like "s0", "s1", "s2", etc., which are useful if you need to modify the values with further search commands;
  • "exact" gives convenient values like "week_of_dec01", "week_of_nov24", etc.

"relative" is the default "series" value.

Q: How can I compare today to yesterday to the avg for the week?

Glad you asked. Search for the last 7 days and run this:

*  
| timechart count span=1h
| timewrap  d series=short
| addtotals s*
| eval 7dayavg=Total/7.0
| table _time, _span, s0, s1, 7dayavg
| rename s0 as now, s1 as yesterday

Basically, we're using timewrap over the last 7 days, and then using addtotals and eval to calculate the average over those 7 days. We then rename fields and cut out days 3-7, because we only wanted today, yesterday, and the weekly average.

Q: What is this 'drilldown' command you threw in for nothing?

Currently in Splunk you cannot drilldown into "other" values from a "top" command. For example, if you searched for "* | top 10 host useother=t", clicking on the "other" value will try to search for "host=other"(!), which is wrong.

I added a little search command that adds a _drilldown field that does the right thing -- it will search for "host=* NOT host=VAL1 NOT host=VAL2 ... NOT host=VAL3". It works with 'top' output.

In your simplexml, you'd then say drilldown on

     $row._drilldown$

This will drilldown on the _drilldown field value.

Release Notes

Version 2.4
July 23, 2014

added support for year, fixing bug.

Version 2.3
July 21, 2014

Added support for "y" year. Assumes 365 days, ignoring leap days.

Version 2.2
April 11, 2014

Added support for s (seconds). For example, an argument of "600s" will timewrap on 10minutes.

Version 2.1
Feb. 3, 2014

Added support for multidigit timespans (e.g. 19h).
Added 'drilldown' command (freebie!), that makes drilldown on 'other' values work.

Version 1.9
Dec. 24, 2013
Version 1.8
Dec. 12, 2013

Added series option to determines the naming convention of the series names: "relative" gives values like "latest_week", "1week_ago", "2weeks_ago", etc.; "short" gives short span names like "s0", "s1", "s2", etc., which are useful if you need to modify the values with further search commands; and "exact" gives convenient values like "week_of_dec01", "week_of_nov24", etc. "relative" is the default SERIES value.

Version 1.7
Dec. 10, 2013

Fixed bug where latesttime was being included, when it should have been excluded.
Improved the name of the series to be more correct and clear, and convenient (no whitespace).

Version 1.6
Dec. 4, 2013
Version 1.5
Dec. 3, 2013
Version 1.4
Dec. 2, 2013

now supports _span field for better time labeling

Version 1.3
Nov. 27, 2013

updated support for improved column ordering and not retaining events

Version 1.2
Nov. 26, 2013

made app invisible because it's just an add-on

Version 1.1
Nov. 26, 2013

updated support for multiple series


Subscribe Share

Are you a developer?

As a Splunkbase app developer, you will have access to all Splunk development resources and receive a 10GB license to build an app that will help solve use cases for customers all over the world. Splunkbase has 1000+ apps from Splunk, our partners and our community. Find an app for most any data source and user need, or simply create your own with help from our developer portal.

Follow Us:
Splunk, Splunk>,Turn Data Into Doing, Data-to-Everything, and D2E are trademarks or registered trademarks of Splunk Inc. in the United States and other countries. All other brand names,product names,or trademarks belong to their respective owners.