annotations.editor.html 2.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344
  1. <div class="gf-form-group">
  2. <div class="gf-form-inline">
  3. <div class="gf-form gf-form--grow">
  4. <textarea rows="10" class="gf-form-input" ng-model="ctrl.annotation.rawQuery" spellcheck="false" placeholder="query expression" data-min-length=0 data-items=100 ng-model-onblur ng-change="ctrl.panelCtrl.refresh()"></textarea>
  5. </div>
  6. </div>
  7. <div class="gf-form-inline">
  8. <div class="gf-form">
  9. <label class="gf-form-label query-keyword" ng-click="ctrl.showHelp = !ctrl.showHelp">
  10. Show Help
  11. <i class="fa fa-caret-down" ng-show="ctrl.showHelp"></i>
  12. <i class="fa fa-caret-right" ng-hide="ctrl.showHelp"></i>
  13. </label>
  14. </div>
  15. </div>
  16. <div class="gf-form" ng-show="ctrl.showHelp">
  17. <pre class="gf-form-pre alert alert-info"><h6>Annotation Query Format</h6>
  18. An annotation is an event that is overlaid on top of graphs. The query can have up to three columns per row, the time column is mandatory. Annotation rendering is expensive so it is important to limit the number of rows returned.
  19. - column with alias: <b>time</b> for the annotation event time. Use epoch time or any native date data type.
  20. - column with alias: <b>text</b> for the annotation text
  21. - column with alias: <b>tags</b> for annotation tags. This is a comma separated string of tags e.g. 'tag1,tag2'
  22. Macros:
  23. - $__time(column) -&gt; column as "time"
  24. - $__timeEpoch -&gt; extract(epoch from column) as "time"
  25. - $__timeFilter(column) -&gt; column BETWEEN '2017-04-21T05:01:17Z' AND '2017-04-21T05:01:17Z'
  26. - $__unixEpochFilter(column) -&gt; column &gt;= 1492750877 AND column &lt;= 1492750877
  27. - $__unixEpochNanoFilter(column) -&gt; column &gt;= 1494410783152415214 AND column &lt;= 1494497183142514872
  28. Or build your own conditionals using these macros which just return the values:
  29. - $__timeFrom() -&gt; '2017-04-21T05:01:17Z'
  30. - $__timeTo() -&gt; '2017-04-21T05:01:17Z'
  31. - $__unixEpochFrom() -&gt; 1492750877
  32. - $__unixEpochTo() -&gt; 1492750877
  33. - $__unixEpochNanoFrom() -&gt; 1494410783152415214
  34. - $__unixEpochNanoTo() -&gt; 1494497183142514872
  35. </pre>
  36. </div>
  37. </div>