Community
Questions Library
Docs
Blog
Events
Swag
Github
Slack
JupiterOne
Discussions
Release Notes
Getting Started with Insights Dashboards - AskJ1 Community
<main> <article class="userContent"> <p>This guide will walk through how to:</p> <ol><li>Import prebuilt Insights Dashboards</li> <li>Create your own custom Insight dashboard</li> </ol><p>The J1 Insights app allows you to build reporting dashboards using J1QL queries.</p> <p>Each dashboard can be configured as either a Team board that is shared with other account users or a Personal board for the individual user.</p> <p>The layout of each board is individually saved per user, including the layout for Team boards, so that each user may configure layouts according to their own preferences without impacting others. Administrators can save a Team board layout as "default" for other users.</p> <p>You can build your own custom dashboards or utilize any of the existing boards that have already been built.</p> <p>Here are a few example boards and their configurations: <a rel="nofollow" href="https://github.com/JupiterOne/insights-dashboards">https://github.com/JupiterOne/insights-dashboards</a>.</p> <h2 data-id="import-prebuilt-insights-dashboards-from-github">Import Prebuilt Insights Dashboards (from GitHub)</h2> <ol><li><p>Navigate to the specific prebuilt dashboard you’d like to import into your JupiterOne account:</p> <p><a rel="nofollow" href="https://github.com/JupiterOne/insights-dashboards">https://github.com/JupiterOne/insights-dashboards</a>.</p></li> <li><p>Pick the specific board, for example, "AWS Accounts".</p></li> <li><p>Click into ‘board.json’.</p></li> <li><p>Right-click <strong>Raw</strong> -> <strong>Save File</strong>.</p> <p></p> <p><img src="https://us.v-cdn.net/6035534/uploads/DTO2070YJ349/save-dashboard.gif" alt="save-dashboard" class="embedImage-img importedEmbed-img"></img></p> <p></p></li> <li><p>Navigate within JupiterOne to <strong>Apps</strong> -> <strong>Insights</strong> to add a board.<br> </p> <p><img src="https://us.v-cdn.net/6035534/uploads/6NT76C0PMSFR/insights.png" alt="insights" class="embedImage-img importedEmbed-img"></img></p></li> <li><p>Expand the left sidebar by clicking the <strong>></strong> carrot .</p></li> <li><p>Click <strong>Add</strong> and choose whether you want a personal or team board.</p></li> <li><p>Click <strong>Upload From JSON Schema</strong> + select the file you previously saved.<br> </p> <p><img src="https://us.v-cdn.net/6035534/uploads/LD8FXJFMB4SD/import-dashboard.gif" alt="import-dashboard" class="embedImage-img importedEmbed-img"></img></p> <p></p> <p>For more information about J1 standard Insights dashboards, <a rel="nofollow" href="https://try.jupiterone.com/blog/video-how-to-modify-out-of-the-box-dashboards">watch this video</a>.</p></li> </ol><h2 data-id="creating-a-custom-insights-dashboard-with-custom-charts-based-on-queries">Creating a Custom Insights Dashboard with Custom Charts Based on Queries</h2> <p>You can build your own custom dashboard with customized individual charts. Each chart is powered by one or more J1QL queries.</p> <ol><li><p>Navigate within JupiterOne to <strong>Apps</strong> -> <strong>Insights</strong> to add a board.<br> </p> <p><img src="https://us.v-cdn.net/6035534/uploads/6NT76C0PMSFR/insights.png" alt="insights" class="embedImage-img importedEmbed-img"></img></p> <p></p></li> <li><p>Expand the left sidebar by clicking the ‘>’ carrot .</p></li> <li><p>Hit the <strong>Add</strong> button’ + choose whether you want a personal or team board.</p></li> <li><p>Click <strong>Start Adding Charts</strong>. This will open up the <strong>Add Chart</strong> workflow where you can customize the details of your query/chart, which include, but aren't limited to:</p></li> </ol><ul><li>type of visual chart, such as number, pie, line, bar.</li> <li>the chart’s query or queries</li> <li><p>formatting options <br> </p> <p><img src="https://us.v-cdn.net/6035534/uploads/0Z5HAY3B0RZ8/custom-board.gif" alt="custom-board" class="embedImage-img importedEmbed-img"></img></p></li> </ul><p>For more information about custom Insights dashboards, <a rel="nofollow" href="https://try.jupiterone.com/blog/how-to-create-customized-dashboards">watch this video</a>.</p> <h3 data-id="additional-support-documentation-resources-for-writing-queries">Additional support documentation/resources for writing queries:</h3> <p><a rel="nofollow" href="https://jupiterone.vanillacommunities.com/kb/articles/844-jupiterone-query-language-tutorial">J1QL query tutorial</a><br><a rel="nofollow" href="https://jupiterone.vanillacommunities.com/kb/articles/836-get-started-with-search">Search quickstart</a><br><a rel="nofollow" href="https://jupiterone.vanillacommunities.com/kb/articles/980-introduction-to-jupiterone-query-language-j1ql">J1QL language specs</a><br><a rel="nofollow" href="https://ask.us.jupiterone.io/filter?tagFilter=all">All questions + queries</a></p> <h2 data-id="general-insights-dashboard-functionality">General Insights Dashboard Functionality</h2> <ul><li><p>Rename, clone, or delete boards:<br> </p> <p><img src="https://us.v-cdn.net/6035534/uploads/A65OKFELK9F1/clone-delete-rename.png" alt="clone-delete-rename" class="embedImage-img importedEmbed-img"></img></p> <p></p></li> <li><p>Download board schema, share boards (create public links), save or reset board layout, add charts:<br> </p> <p><img src="https://us.v-cdn.net/6035534/uploads/PR4RIXVI9DU0/share-download-add-layout.png" alt="share-download-add-layout" class="embedImage-img importedEmbed-img"></img></p> <p></p></li> <li><p>Delete charts:<br> </p> <p><img src="https://us.v-cdn.net/6035534/uploads/5U95839GBJMF/delete-widget.png" alt="delete-widget" class="embedImage-img importedEmbed-img"></img></p> <p></p></li> <li><p>Reorder either charts within a specific board, or the board within the side panel by dragging the chart or board to the desired spot:<br> </p> <p><img src="https://us.v-cdn.net/6035534/uploads/RIBW560RV1Q9/reorder.gif" alt="reorder" class="embedImage-img importedEmbed-img"></img></p></li> </ul><p>To see more examples of editing charts and graphs in an Insights dashboard, <a rel="nofollow" href="https://try.jupiterone.com/blog/how-to-use-charts-and-graphs-widgets">watch this video</a>.</p> </article> </main>