Tyler Muth’s Blog

Technology with a focus on Oracle, Application Express and Linux

AWR Formatter

Posted by Tyler Muth on April 20, 2011

I’ve found myself looking at a lot of AWR Reports lately and doing the same calculations on them over and over. Converting gets / reads / bytes to KB / MB / GB / TB, converting seconds to hours minutes and seconds, etc. So, I wrote a few lines (~25) of JavaScript (using jQuery) to do some of this math for me. Like many projects, it quickly grew and grew. So, 2,000+ lines of JavaScript later, I present to you a google chrome plugin I’ve creatively entitled “AWR Formatter”.

It will not tune your database nor end world hunger, it just makes AWRs a lot easier to read. I did attempt to make some “observations”, but I certainly want to be careful with these. Currently it works with 10.2+ (maybe 10.1) single-node reports. It does not work on RAC / Global reports or on compare period reports but I’m going to start on those soon.

Thanks to Tom Kyte, Graham Wood, Robert Freeman and Tom Roach for your contributions.

Installation

Features (screencast at the end)

  • “Smart Text” conversion of gets / reads / bytes to KB / MB / GB / TB. You can click the orange text to cycle through these units
  • Medium size tables are sortable
  • Large tables are searchable
  • All documented wait events are “hot” and local definitions are included
  • Nicely formatted SQL Full text popup
  • Combined view of key Top SQL sections
  • “Observations” including:
    • Time period of AWR > 60 minutes
    • Hidden / undocumented parameter use
    • Highlight memory recommendations from AWR
  • Link to MOS note for “PX” events
  • Link to documentation for  ”gc” events
  • I/O Graphs of tablespace activity
  • Updates to the extension are delivered automatically as I release new versions
  • I am not collecting any data or sending any data to myself or anywhere else. You can review the code anytime via the instructions in the last paragraph
You can watch a screencast of it in action here. If you need a “demo” AWR Report, you can download this report from an Exadata 1/4 rack. As always, feedback or enhancement requests are welcome. If you want to view the source, just change the file extension from .crx to .zip and unzip it.
About these ads

52 Responses to “AWR Formatter”

  1. David Mann said

    Fantastic idea. Lots of usability features that will help keep my eyes from crossing while scouring AWR reports. Can’t wait to check this out.

  2. Excellent work Tyler. I have a couple of observations

    First – it turned my laptop into an Exadata box, which is nice but unlikely. It appears that on 11.2.0.2 on windows at least cellInterconnectBytes gets populated for non exadata databases (I have a vague memory that this might be a known bug).

    Second it would be nice to exclude the findings about hidden parameters that take their default values – i.e are not user set, again 11.2.0.2 on windows.

    very nice work though.

  3. [...] awr formatter -  firefox plugin  for AWR browsing – see screencast [...]

  4. great work thanks for sharing with community.

  5. orawiss said

    Hello Tyler,
    Thanks so much! But, do you think the plugin will work on Fedora Linux for me?

    Best reagards,
    Wissem

  6. orawiss said

    It’s fedora 14.

  7. Tom said

    I use it on Ubuntu/Chrome so can’t imagine why it wouldn’t work on Fedora. Just make sure you go to “Wrench>Tools>Extension” to enable local file access for the plugin.

    It works for me on Linux and should work for you.

    • orawiss said

      Thank you Tom, I will try it.
      Cheers,
      Wissem

    • orawiss said

      After installation of google chrome, I received an error “google chrome error Invalid value for permissions[1]” When installing the plugin.

      After updating Google chrome with the command “yum update google-chrome” as a root, the installation of the plugin works perfectly.

      Thanks

  8. Jishar said

    Great tool…keep it up…Good work.

    Can you let me know once the tool ready for RAC.

    email id: jisharibrahim@gmail.com

  9. Hi,

    For a neat trick to convert bytes information into KB, MB… up to YB, please refer to my following (updated) blog post:
    http://raptorreports.blogspot.com/2010/07/bytes-converter-sql-to-convert-bytes-to.html

    it is pure SQL and easy to integrate into your existing SQL reports. I make extensive use of it in mine.

    Donat

    • Tyler Muth said

      @Donat,

      While you have come up with a creative solution for SQL, unfortunately this plugin doesn’t use any SQL at all. It’s 100% JavaScript (with jQuery).

      Regards,
      Tyler

  10. Tyler Muth said

    Updated yesterday and today (1.2 > 1.3 > 1.4). Added CSV Export (needed for a current project) and enqueue wait definitions (took ~3 minutes thanks to previous design decision + this post: http://venzi.wordpress.com/2010/12/10/oracle-11gr2-enqueue-waits to find the definitions.

    Enjoy!
    Tyler

  11. Hi Tyler,

    thank you for this awesome tool. I’ve been using it for a week now and all I can say is why nobody didn’t this earlier. Thanks a lot and please keep it going.

  12. Jan Schnackenberg said

    This is wonderful. Just by a quick test with an old AWR Report on my disk I was amazed by how much easier I would have come to the same conclusion, had this tool been available when I needed to analyze this report.

    Thanks for your work!

  13. Jigar said

    Awesome!! Very useful. Thanks a lot.

  14. Alberto said

    Great tool, very very useful…thanks a lot.

  15. Nitin said

    Hi tyler,
    i am unable to install that extension .

    I am getting following error .

    ” Invalid value for ‘Permission[1]‘ “

    • orawiss said

      Please see my comment above “After updating Google chrome with the command “yum update google-chrome” as a root, the installation of the plugin works perfectly.

    • orawiss said

      Please see my comment above “After updating Google chrome with the command “yum update google-chrome” as a root, the installation of the plugin works perfectly.

      Wissem

  16. Very very useful stuff. Thanks :)

  17. Senthil said

    Great Work! Any plans to make this plug-in available for other browsers like IE and FireFox?

    Senthil

    • Tom said

      The plugin source code is available and you can create a plugin for those with this. It probably won’t be as easy as Google Chrome. In addition I doubt it will perform as well as Google Chrome because of how well it handles javascript.

  18. [...] the opportunity a while ago to meet Tyler Muth and he really knows his stuff. He recently made a Chrome plugin that makes reading and filtering AWR reports a breeze. Highly recommend [...]

  19. Hazem Adel said

    This is really useful, great work.

  20. Uwe Hesse said

    Thank you very much, Tyler, for this useful tool! As Timur said already: Wonder why nobody did that earlier. Keep up the good work!

  21. enrique Ortiz said

    very cool , it explains awr concepts easy !!!!!

  22. Arun Gupta said

    Thanks Tyler for this great utility. I have noticed an issue.
    01. Open AWR report in a tab.
    02. Open a second tab and navigate to any website.
    03. Go back to AWR report tab.
    04. The formatting is completely messed up.
    05. I have to close the second tab and reformat report.

    Since no one else has reported this, I am not sure if it is something specific to my desktop. Chrome version 11.0.696.71 running on Windows XP.

    • Arun Gupta said

      Please ignore the issue. It seems Chrome doesn’t play well with firewalls and proxy authentication.

  23. oraculix said

    This
    is
    AWESOME!

    I liked it when I first checked it out shortly after you posted it. Today I gave it a longer try for an in-depth analysis of a busy DWH and started to love how it rids me from scrolling up and down the reports all the time.
    Thank you for your great efforts, Tyler!

  24. This is awesome

  25. [...] AWR Formatter [...]

  26. Suv said

    This is ultimeto :-) …Going to do some more experiments with the tool !

  27. agleite said

    Hi Tyler,

    thank you for this awesome tool. Thanks for sharing with community.

    Alessandro

  28. [...] no próprio site do Tyler como instalar e configurar: http://tylermuth.wordpress.com/2011/04/20/awr-formatter/ Share this:FacebookEmailPrint análise de awr, awr, awr formatter, formato awr, oracle Address: [...]

  29. Joe Khoo said

    Excellent tool and thanks for sharing this with the community.

    This reminds me of the guy who create the NMON Analyzer thingy.

    We’ll probably see this as one of the staple tools for many DBAs. At least I am gonna make sure those from by company will start using this.

    May I ask, how many hours actually went into the creation of this thing?

    Just an idea, how about expanding this so that it can summarize the details from several AWR reports?
    Or making it a community project kind of thing?

  30. wordpress business themes,best wordpress business themes,business themes wordpress…

    [...]AWR Formatter « Tyler Muth’s Blog[...]…

  31. Chris said

    Need additional places to download the plug-in. Dropbox is blocked by most corporations.

  32. [...] http://tylermuth.wordpress.com/2011/04/20/awr-formatter/ [...]

  33. [...] Druckansicht [...]

  34. Very nice tool to work with … thanks for sharing

  35. sandeep said

    How about for the latest Chrome?

  36. Tyler Muth said

    Direct installation of chrome extensions from 3rd party sites (not in the chrome store) was recently disabled by google to protect against malicious extensions. Here’s more information on the change: http://support.google.com/chrome_webstore/bin/answer.py?hl=en&answer=2664769&p=crx_warning

    There is a workaround documented on that page:
    1. Download the extension file from the website and save it to your computer.
    2. Click the wrench icon on the browser toolbar.
    3. Select Tools > Extensions.
    4. Locate the extension file on your computer and drag the file onto the Extensions page.
    5. Review the list of permissions in the dialog that appears. If you would like to proceed, click Install.

    I understand and support this move by google in light of the security risks. I will work to get this extension into the chrome web store (for free) next week. I’ve had a few emails asking why I don’t charge for it. While appreciate the compliment, it’s my desire to provide this utility for free to make AWR a bit more approachable. I also have a new version in the works, but there are only so many hours in the day…

    • Venkatesh Naicker said

      Hi Tyler, did you get a chance to upload the extension into chrome web store. If yes, what’s the name of the extension? Thanks!

  37. joao said

    Great tool, I have a doubt.
    In the video appears the example of units “Physical reads – Per second” …
    the original value is 206,326.4 but translated to GB appears 3,380,402,585.6.
    Why? Should not to be 0,0002 GB?
    What did I lose?

    Sorry my bad english

  38. [...] Check out the AWR formatter plugin for Chrome: http://tylermuth.wordpress.com/2011/04/20/awr-formatter/ [...]

  39. Dana Day said

    AWR Formatter is great. The value of the combined SQL “spreadsheet” should be a standard part of Oracle AWR reporting.

  40. gram said

    Hello

    When i try to install AWR formatter, chrome returns thant plugin is not possible to install…..any ideas ?

    thanks

  41. gram said

    it is ok know.
    very nice plugin :)
    thanks
    regards

  42. Shyam said

    Tyler,
    Very Handy plugin! Consolidated 360 view. Thank you!!

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Connecting to %s

 
Follow

Get every new post delivered to your Inbox.

Join 69 other followers

%d bloggers like this: