{"_id":"59517785bb93f700353caac2","project":"56ba46e2ce5d540d00e2d7a7","version":{"_id":"56ba46e2ce5d540d00e2d7aa","project":"56ba46e2ce5d540d00e2d7a7","__v":13,"createdAt":"2016-02-09T20:06:58.727Z","releaseDate":"2016-02-09T20:06:58.727Z","categories":["56ba46e3ce5d540d00e2d7ab","5771a6b145c7080e0072927f","5771a72eb0ea6b0e006a5221","5772e5b20a6d610e00dea073","577c3006b20f211700593629","57ae587bca3e310e00538155","57ae593a7c93fa0e001e6b50","57b1f8263ff6c519005cf074","582601f155b1060f00ec4173","582a62857a96051b0070b011","58ebfae58d5a860f00851fb9","590a75a1ec0d5e190095ab38","59e5253fd460b50010237bed"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"582601f155b1060f00ec4173","project":"56ba46e2ce5d540d00e2d7a7","__v":0,"version":"56ba46e2ce5d540d00e2d7aa","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-11-11T17:37:53.355Z","from_sync":false,"order":1,"slug":"guides","title":"Guides"},"user":"5732062ad720220e008ea1d2","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-06-26T21:07:17.949Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":7,"body":"This guide covers how to use the Graphs feature accessible via the graphs tab in the top left of the LogDNA web app. Please note that at the time of writing, our visualization features are currently in public beta.\n\n## Boards\n\nA board is a named collection of graphs and is analogous to a view. All boards are located in the Boards List and may contain any number of graphs. Changes made to a board are automatically saved.\n\n### Creating a board\n\nTo create a board, click the New Board button at the top of the Boards List. You can name and rename your board at the top of the page.\n\n### Managing a board\n\nRelated board actions are available in the hamburger-style Board Menu in the top left, analogous to the View Menu. Inside the Board Menu, you can set a default color for graphs inside the board, duplicate a copy of the board, and even delete a board.\n\n### Setting a duration\n\nDirectly to the right of the Board Menu is the Duration Menu. From within the Duration Menu you can set a time range for all graphs inside this board. You can select one of many duration options between 30 minutes and 7 days.\n\n### Reordering boards\n\nSimilar to views, all of your users have access to all boards in your account and each user can reorder their Board List to their liking. To modify the position of a board, mouse over the board and click, and drag the grippy texture on the left.\n\n## Graphs\n\nA graph is a visual representation of your parsed log data over time. For each graph, you can adjust the name, color, and dataset filter.\n\n### Creating a graph\n\n1. Ensure you are inside a board.\n2. Click the Add a Graph button in the middle of the page.\n3. Select a parsed field to plot.\n4. For string fields, the only available metric is count. However, for numeric fields, you can choose counts, min, max, average, sum, diff, or select percentiles. For more details, see [Understanding Metrics](https://docs.logdna.com/docs/graphs#section-understanding-metrics).\n5. Optionally filter your dataset using our [standard search syntax](doc:search).\n6. Click the Add a Graph button.\n\n### Managing a graph\n\nMousing over a graph will display icons designating the actions available for that graph.\n\n  * **Filled circle**: Sets the precise color of the graph\n  * **Pencil**: Sets the name of the graph\n  * **Funnel**: Modifies the applied dataset filter\n  * **Two squares**: Duplicates the graph and inserts it directly below\n  * **X**: Deletes the graph\n\nBy default, the name of the graphed field is displayed on the left, but if set, the name of the graph will be displayed instead. For numeric fields, you can also change the metric function by clicking on this name and selecting counts, min, max, average, sum, diff, or a percentile preset. For more details, see [Understanding Metrics](https://docs.logdna.com/docs/graphs#section-understanding-metrics).\n\n### Reordering graphs\n\nYou can manually set the order of graphs for any board. To modify the position of a graph, mouse over the graph, and click and drag the grippy texture at the top center of the graph.\n\n### Jump to logs\n\nWhen you mouse over a bar in a graph, that bar is highlighted and the associated value is displayed. If you click on a bar in a graph, the jump to logs button will appear. Click this button to be taken directly to the logs counted for that bar of the graph.\n\n## Understanding metrics\n\nA metric is an aggregate function that transforms a graphed dataset in particular way. While you can graph any parsed field, only numeric fields can utilize the full list of metric functions. All metric functions only apply to data that contains the selected field and matches the applied dataset filter.\n\n* **Counts**: Counts the number of lines in each interval. This is the only metric function that can be applied to string fields.\n* **Min**: Returns the lowest value for each interval.\n* **Max**: Returns the highest value for each interval.\n* **Average**: Returns the average value for each interval\n* **Sum**: Returns the sum of values for each interval\n* **Diff**: Returns the largest difference between values for each interval\n* **Percentiles**: Returns the Nth percentile of a set of values for each interval. You can choose from the 75th, 85th, 95th, and 99th percentile presets.","excerpt":"","slug":"graphs","type":"basic","title":"Graphs"}
This guide covers how to use the Graphs feature accessible via the graphs tab in the top left of the LogDNA web app. Please note that at the time of writing, our visualization features are currently in public beta. ## Boards A board is a named collection of graphs and is analogous to a view. All boards are located in the Boards List and may contain any number of graphs. Changes made to a board are automatically saved. ### Creating a board To create a board, click the New Board button at the top of the Boards List. You can name and rename your board at the top of the page. ### Managing a board Related board actions are available in the hamburger-style Board Menu in the top left, analogous to the View Menu. Inside the Board Menu, you can set a default color for graphs inside the board, duplicate a copy of the board, and even delete a board. ### Setting a duration Directly to the right of the Board Menu is the Duration Menu. From within the Duration Menu you can set a time range for all graphs inside this board. You can select one of many duration options between 30 minutes and 7 days. ### Reordering boards Similar to views, all of your users have access to all boards in your account and each user can reorder their Board List to their liking. To modify the position of a board, mouse over the board and click, and drag the grippy texture on the left. ## Graphs A graph is a visual representation of your parsed log data over time. For each graph, you can adjust the name, color, and dataset filter. ### Creating a graph 1. Ensure you are inside a board. 2. Click the Add a Graph button in the middle of the page. 3. Select a parsed field to plot. 4. For string fields, the only available metric is count. However, for numeric fields, you can choose counts, min, max, average, sum, diff, or select percentiles. For more details, see [Understanding Metrics](https://docs.logdna.com/docs/graphs#section-understanding-metrics). 5. Optionally filter your dataset using our [standard search syntax](doc:search). 6. Click the Add a Graph button. ### Managing a graph Mousing over a graph will display icons designating the actions available for that graph. * **Filled circle**: Sets the precise color of the graph * **Pencil**: Sets the name of the graph * **Funnel**: Modifies the applied dataset filter * **Two squares**: Duplicates the graph and inserts it directly below * **X**: Deletes the graph By default, the name of the graphed field is displayed on the left, but if set, the name of the graph will be displayed instead. For numeric fields, you can also change the metric function by clicking on this name and selecting counts, min, max, average, sum, diff, or a percentile preset. For more details, see [Understanding Metrics](https://docs.logdna.com/docs/graphs#section-understanding-metrics). ### Reordering graphs You can manually set the order of graphs for any board. To modify the position of a graph, mouse over the graph, and click and drag the grippy texture at the top center of the graph. ### Jump to logs When you mouse over a bar in a graph, that bar is highlighted and the associated value is displayed. If you click on a bar in a graph, the jump to logs button will appear. Click this button to be taken directly to the logs counted for that bar of the graph. ## Understanding metrics A metric is an aggregate function that transforms a graphed dataset in particular way. While you can graph any parsed field, only numeric fields can utilize the full list of metric functions. All metric functions only apply to data that contains the selected field and matches the applied dataset filter. * **Counts**: Counts the number of lines in each interval. This is the only metric function that can be applied to string fields. * **Min**: Returns the lowest value for each interval. * **Max**: Returns the highest value for each interval. * **Average**: Returns the average value for each interval * **Sum**: Returns the sum of values for each interval * **Diff**: Returns the largest difference between values for each interval * **Percentiles**: Returns the Nth percentile of a set of values for each interval. You can choose from the 75th, 85th, 95th, and 99th percentile presets.