6000101820 2015-08-12T07:46:30-04:00 Follow these simple step-by-step instructions to familiarize yourself with the many features of Circonus. This is the best way to get started with Circonus. For maximum results, work through these tutorials in order. 6000158965 false Start Here: New User Walkthrough 1 2015-08-12T07:46:30-04:00 1 1 2015-08-12T08:02:50-04:00 1 5 If you're new to Circonus and want a quick overview of what it's all about, this "Getting Started" tutorial is for you. The tutorial will take you through setting up a check, graphing the data collected by the check, and alerting on a check. Next Step: Terminology, or you can dive in with C:OSI:  C:OSI for One Step Install of new Hosts C:OSI will help you onboard new hosts and automatically generate basic checks, graphs, and worksheets. Or jump to these highlights in the walkthrough and learn to create: Step 1: Checks Step 2: Graphs Step 3: Alerts Step 4: Analytics Step 5: Custom Dashboards This tutorial includes a number of simple tasks that you'll need to do in your own Circonus deployment. Several of the steps include video tutorials so you can follow along, as well as step-by-step instructions. We will also touch on some of the more advanced features that are covered in more detail in separate articles. If you haven't already signed up for your free Circonus account, request a free account now! Or if you already have an account, you can return to login. <div dir="ltr"><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div> <p><span></span></p> <p style="text-align: left;"><br></p> <div style="text-align: center;"><p style="background-color: rgb(255, 255, 255);"><a href="6000064662-circonus-terminology"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026328177/original/blob1467223810166.png?1467223803" class="inline-image fr-dii fr-draggable" data-id="6026328177"></a> <a href="6000064662-circonus-terminology"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026328171/original/blob1467223801842.png?1467223795" class="inline-image fr-dii fr-draggable" data-id="6026328171"></a> <a href="6000064662-circonus-terminology"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026326951/original/blob1467222840446.png?1467222833" class="inline-image fr-dii fr-draggable" data-id="6026326951" alt=""></a></p></div> <br><p><span>If you're new to Circonus and want a quick overview of what it's all about, this "Getting Started" tutorial is for you. </span><span>The tutorial will take you through setting up a check, graphing the data collected by the check, and alerting on a check.</span></p> <p><br></p> <p>Next Step: <a href="6000064662-circonus-terminology" style="line-height: 16px;" target="">Terminology</a>, or you can dive in with C:OSI: </p> <p style="text-align: center;"><br><u><span style="font-size: x-large;"><a href="6000130747-c-osi-tutorial" style="font-size: 24px; background-color: rgb(255, 255, 255);" target="">C:OSI for One Step Install of new Hosts</a></span></u><br>C:OSI will help you onboard new hosts and automatically generate basic checks, graphs, and worksheets.<br><br><span style="text-align: start;">Or jump to these highlights in the walkthrough and l</span><span>earn to create:</span></p> <p style="text-align: center;"><br><u style="background-color: rgb(255, 255, 255);"><span style="font-size: x-large;"><a href="6000040825-create-a-check" style="background-color: rgb(255, 255, 255);" target="">Step 1: Checks</a></span></u></p> <p style="text-align: center;"><font size="5"><u><br></u></font><br><u><a href="6000040834-create-a-graph" target=""><span style="font-size: x-large;">Step 2: Graphs</span></a></u><br><br><br><a href="6000040841-create-an-alert" style="background-color: rgb(255, 255, 255);" target=""><u><span style="font-size: x-large;">Step 3: Alerts</span></u></a><br><br><br><a href="6000040847-apply-analytics-overlays-" style="background-color: rgb(255, 255, 255);" target=""><u><span style="font-size: x-large;">Step 4: Analytics</span></u></a><br><u><br><br></u><a href="6000040875-create-a-dashboard" style="background-color: rgb(255, 255, 255);" target=""><u><span style="font-size: x-large;">Step 5: Custom Dashboards</span></u></a><br></p> <p style="text-align: left;"><br></p> <p style="text-align: left;"><br></p> <p style="text-align: left;"><span>This tutorial includes a number of simple tasks that you'll need to do in your own Circonus deployment. </span><span style="text-align: initial;">Several of the steps include video tutorials so you can follow along, as well as step-by-step instructions. </span><span style="text-align: initial;">We will also touch on some of the more advanced features that are covered in more detail in separate articles.</span></p> <p><br></p> <p>If you haven't already signed up for your free Circonus account, <a href="https://login.circonus.com/signup" target="_blank">request a free account now</a>! Or if you already have an account, you can return to <a href="https://login.circonus.com/" target="">login</a>.</p> <p><br></p> <p style="text-align: center;"><a href="6000064662-circonus-terminology" style="background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026328177/original/blob1467223810166.png?1467223803" data-id="6026328177" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000064662-circonus-terminology" style="background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026328171/original/blob1467223801842.png?1467223795" data-id="6026328171" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000064662-circonus-terminology" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026326951/original/blob1467222840446.png?1467222833" data-id="6026326951" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a></p> </div></div></div></div></div></div></div></div></div></div></div></div></div></div> 6000158965 1227 6000040818 2017-09-20T15:02:24-04:00 6003235491 1 2 1 5 Introduction 2015-08-12T08:02:50-04:00 6002695175 1 2015-09-21T08:46:55-04:00 2 2 To get the most out of your Circonus deployment, it's important to understand just a couple of key terms. Broker - a software appliance that communicates with each of your devices, systems, websites, databases, and other data sources. It can speak many different languages and protocols, including HTTP, JSON, SQL, JMX, and TCP. Public brokers are available to any Circonus SaaS customer, and are distributed around the world. Public brokers are often used to monitor publicly-accessible hosts or services. Enterprise brokers are available for purchase so you can run our broker software within your data center. This option allows you to open a single SSL port from our central systems to your network. Check - a definition of what you want the broker to collect. The details you provide in the check often include the hostname/IP, port, any username or password required, headers that may be needed, timeouts, URLs, and other settings. During the check setup, you select which broker(s) you would like the check to run on. Metric - an individual piece of data that a broker collects for a defined check. For instance, the “Ping” check collects availability, average ping time, maximum time, minimum time, and number of packets sent. Each of these items is a metric collected from the broker for that check. The article, Circonus Glossary of Terms, contains additional information about definitions of common and uncommon terms, and this article describes describes the different Data Types used in Circonus. Next Step: Create a Check <div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"> <p><span></span></p> <p style="text-align: center;"><a href="6000040818-introduction"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" class="inline-image fr-dii fr-draggable" data-id="6026541175" alt=""></a> <a href="6000040818-introduction"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" class="inline-image fr-dii fr-draggable" data-id="6026541174" alt=""></a> <a href="6000040825-create-a-check"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" class="inline-image fr-dii fr-draggable" data-id="6026541166" alt=""></a></p> <p><span><br></span></p> <p><span>To get the most out of your Circonus deployment, it's important to understand just a couple of key terms.</span></p> <p><br></p> <p><strong>Broker - </strong>a software appliance that communicates with each of your devices, systems, websites, databases, and other data sources. It can speak many different languages and protocols, including HTTP, JSON, SQL, JMX, and TCP. Public brokers are available to any Circonus SaaS customer, and are distributed around the world. Public brokers are often used to monitor publicly-accessible hosts or services. Enterprise brokers are available for purchase so you can run our broker software within your data center. This option allows you to open a single SSL port from our central systems to your network.<br></p> <p><br></p> <p><b style="font-size: 13px;">Check</b> - a definition of what you want the broker to collect. The details you provide in the check often include the hostname/IP, port, any username or password required, headers that may be needed, timeouts, URLs, and other settings. During the check setup, you select which broker(s) you would like the check to run on.</p> <p><br></p> <p><b style="font-size: 13px;">Metric</b> - an individual piece of data that a broker collects for a defined check. For instance, the “Ping” check collects availability, average ping time, maximum time, minimum time, and number of packets sent. Each of these items is a metric collected from the broker for that check.</p> <p><br></p> <p>The article, <a href="6000105708-circonus-glossary-of-terms" target="">Circonus Glossary of Terms</a>, contains additional information about definitions of common and uncommon terms, and this article describes describes the different <a href="6000066958-data-types-in-circonus-text-numeric-histogram-and-beacons" target="">Data Types</a> used in Circonus.</p> <p><br></p> <p>Next Step: <a href="6000040825-create-a-check" style="font-size: 13px;" target="">Create a Check</a></p> <p><br></p> <p style="text-align: center;"><a href="6000040818-introduction"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" style="text-align: center;" alt="" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040825-create-a-check"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" style="text-align: center;" alt="" class="fr-dii fr-draggable"></a><br></p> </div></div></div></div></div> 6000158965 645 6000064662 2017-09-20T15:00:56-04:00 6003235491 2 2 2 2 Circonus Terminology 2016-05-02T15:10:57-04:00 6002695175 1 2015-08-12T08:07:58-04:00 0 3 Create Your First Check In order to start collecting data, you’ll need to make checks that pertain to the type of data you’d like. For instance, if you’re trying to monitor a website, you might use the check types of Nginx, Apache, Ping, or HTTP. If you’re trying to get system metrics from a Linux server, you could use Collectd, Statsd, the Circonus Node Agent, or SNMP. Each check has various configuration options, such as the timeout, URL, headers, username and password, or port number. You’ll also need to tell Circonus which broker you’d like the check to be run from. Once you’ve got this set up, Circonus will start collecting data. Adding a check is a simple process: Navigate to either the "Checks" screen or the "Metrics" screen, both located under the "Collect" section of the main menu.             Click the "New Check +" button to open the first step of the check creation wizard.             There are two navigation options for finding the type of check you wish to use: Search bar - The search is performed against the Check name, its description, and internal keywords. It provides interactive "search as you type" capability and will display all matching options as you type your search term. This is the quickest and easiest navigation mechanism if you are already familiar with the check types available in Circonus. Hierarchical navigation - All possible check types in Circonus are listed and divided into categories. Simply browse this list and select your check type. You can hover over a check in this list to view a description. The next step is select a broker for the check. Circonus handles this step differently for perspective checks and non-perspective checks: If Circonus considers the check to be a perspective check, it will display a map allowing you to select a set of brokers. The check will be run from the selected brokers. You must select at least one broker, but you are not limited to one. You can see a list of the brokers located at each dot on the map by hovering over a map location with your mouse. Select specific brokers by checking the checkboxes in the list on the right. To deselect a broker, uncheck the broker in the list. Circonus considers a check to be non-perspective if the results will not vary based on the broker performing the assessment. In this case, it makes sense to select only a single broker, so a drop down menu is provided instead of a map. When finished selecting a check type, click the "Configure Check >>" button. This next part of the process varies widely based on the check type selected. For the purposes of this example, we'll be using the HTTP check type to check the main circonus.com website. The HTTP check requires a URL and, like most checks, will resolve any FQDN and provide a choice of using the FQDN (i.e. circonus.com) or the resolved IP address (i.e. 66.225.209.241). In this example, we'll leave the IP address selected, and forego any advanced HTTP-specific configuration.             Click the "Test Check" button. The broker that you selected will be asked to run the check in test mode. This may take a few seconds, but it will retrieve all the metrics and let you pick and choose which metrics will have collection enabled. You have the option to rename your check to something more descriptive or appropriate. Note that the host, the type, and the perspective from which it is run are metadata associated with each check, so using that information in the name would be redundant.            The last task is to select the metrics for which you want to enable collection. Those that are selected will be the only ones transmitted from the broker back into the rest of Circonus and as a result will be available for alerting and visualization. Those that are not selected will simply be ignored. You can come back and change these selections later, but while they are deselected no data will be collected. The "Filter Results" box will allow quick reduction of the list for fast selection/deselection for large result sets. This can be used with "All" and "None" to quickly and painlessly work with very large lists of metrics. Once satisfied with the metric selection, click "Finish" to place the check on the broker and make its output available to the rest of the tools in Circonus. You can also watch a short video of the process using a different example check type here: Adding a Ping Check Next Step: Create a Graph <div dir="ltr"><div dir="ltr"><div dir="ltr"><div> <p style="text-align: center;"><a href="6000064662-circonus-terminology"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" style="text-align: center; width: 100px; height: 60px;" data-height="60" alt="" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040834-create-a-graph"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" style="text-align: center;" alt="" class="fr-dii fr-draggable"></a><span style="font-size: 18px; font-family: helvetica; color: rgb(16, 129, 149);"><br></span></p> <p><span style="font-size: 18px; font-family: helvetica; color: rgb(16, 129, 149);">Create Your First Check</span></p> <p><span>In order to start collecting data, you’ll need to make checks that pertain to the type of data you’d like. For instance, if you’re trying to monitor a website, you might use the check types of Nginx, Apache, Ping, or HTTP. If you’re trying to get system metrics from a Linux server, you could use Collectd, Statsd, the Circonus Node Agent, or SNMP.</span><br></p> <p><br></p> <p>Each check has various configuration options, such as the timeout, URL, headers, username and password, or port number. You’ll also need to tell Circonus which broker you’d like the check to be run from. Once you’ve got this set up, Circonus will start collecting data.</p> <p><br></p> <p>Adding a check is a simple process:</p> <ol> <li>Navigate to either the "Checks" screen or the "Metrics" screen, both <span>located under the "Collect" section of the main menu.<br><div style="text-align: left;"> <span>           </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003706333/original/Mainmenu.png?1440189198" class="inline-image fr-dii fr-draggable" data-id="6003706333" data-height="311" style="cursor: default; height: 311px; width: 395px;"> </div></span> </li> <li>Click the "New Check +" button to open the first step of the check creation wizard.<br><span>           </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003706533/original/NewCheckbutton.png?1440189472" class="inline-image fr-dii fr-draggable" data-id="6003706533" alt="" data-height="106" style="cursor: default; width: 159.716px; height: 106px;"> </li> <li>There are two navigation options for finding the type of check you wish to use:<ol> <li>Search bar - <span>The search is performed against the Check name, its description, and internal keywords. It p</span>rovides interactive "search as you type" capability and will display all matching options as you type your search term. This is the quickest and easiest navigation mechanism if you are already familiar with the check types available in Circonus.</li> <li> <span>Hierarchical navigation - </span><span>All possible check types in Circonus are listed and divided into categories. Simply browse this list and select your check type. You can hover over a check in this list to view a description</span><span>.<br><p><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003706475/original/data_check_1_2.png?1440189407" class="inline-image fr-dii fr-draggable" data-id="6003706475" data-height="476" style="cursor: default; height: 476px;"></p></span> </li> </ol> </li> <li> <span>The next step is select a broker for the check. Circonus handles this step differently for perspective checks and non-perspective checks:</span><ol> <li> <span>If Circonus considers the check to be a perspective check, it will display a map allowing you to select a set of brokers. The check will be run from the selected brokers. You must select at least one broker, but you are not limited to one. </span><span>You can see a list of the brokers located at each dot on the map by hovering over a map location with your mouse. </span><span>Select specific brokers by checking the checkboxes in the list on the right. To deselect a broker, uncheck the broker in the list.<br><p><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003707040/original/data_check_2_map2.png?1440190203" class="inline-image fr-dii fr-draggable" data-id="6003707040" style="cursor: default; width: 784.541px; height: 267px;" data-height="267"></p></span> </li> <li>Circonus considers a check to be non-perspective if the results will not vary based on the broker performing the assessment. In this case, it makes sense to select only a single broker, so a drop down menu is provided instead of a map.<p><span></span></p> <p><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003707043/original/data_check_2_selectone2.png?1440190231" class="inline-image fr-dii fr-draggable" data-id="6003707043" style="cursor: default; width: 782.571px; height: 166px;" data-height="166"></p> </li> </ol> </li> <li> <span>When finished selecting a check type, click the "Configure Check &gt;&gt;" button. </span><span>This next part of the process varies widely based on the check type selected. For the purposes of this example, we'll be using the HTTP check type to check the main circonus.com website.</span> </li> <li>The HTTP check requires a URL and, like most checks, will resolve any FQDN and provide a choice of using the FQDN (i.e. circonus.com) or the resolved IP address (i.e. 66.225.209.241). In this example, we'll leave the IP address selected, and forego any advanced HTTP-specific configuration.<p><span></span></p> <p>           <img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003707430/original/data_check_3_http.png?1440191035" class="inline-image fr-dii fr-draggable" data-id="6003707430" style="cursor: default; width: 791.98px; height: 376px;" data-height="376"></p> </li> <li>Click the "Test Check" button. The broker that you selected will be asked to run the check in test mode. This may take a few seconds, but it will retrieve all the metrics and let you pick and choose which metrics will have collection enabled.</li> <li> <span>You have the option to rename your check to something more descriptive or appropriate. Note that the host, the type, and the perspective from which it is run are metadata associated with each check, so using that information in the name would be redundant.<br>          </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003707649/original/data_check_4_1.png?1440191565" class="inline-image fr-dii fr-draggable" data-id="6003707649" data-height="243" style="cursor: default; height: 243px; width: 801.805px;"> </li> <li> <span>The last task is to select the metrics for which you want to enable collection. Those that are selected will be the only ones transmitted from the broker back into the rest of Circonus and as a result will be available for alerting and visualization. Those that are not selected will simply be ignored. You can come back and change these selections later, but while they are deselected no data will be collected. </span>The "Filter Results" box will allow quick reduction of the list for fast selection/deselection for large result sets. This can be used with "All" and "None" to quickly and painlessly work with very large lists of metrics.<p><span></span></p> <p><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003707527/original/data_check_4_3.png?1440191296" class="inline-image fr-dii fr-draggable" data-id="6003707527" style="cursor: default; width: 650.592px; height: 426px;" data-height="426"></p> </li> <li><span>Once satisfied with the metric selection, click "Finish" to place the check on the broker and make its output available to the rest of the tools in Circonus.</span></li> </ol> <p><br></p> <p>You can also watch a short video of the process using a different example check type here: <a href="https://www.youtube.com/watch?v=bR7eDXiWfa8" style="line-height: 16px;" target="_blank">Adding a Ping Check</a></p> <p><br></p> <div style="text-align: center;"><span class="fr-video fr-dvi fr-draggable" style=""><iframe width="560" height="315" src="https://www.youtube.com/embed/bR7eDXiWfa8" frameborder="0" allowfullscreen="" style="text-align: initial;" sandbox="allow-scripts allow-forms allow-same-origin allow-presentation"></iframe></span></div> <p><br></p> <p>Next Step: <a href="6000040834-create-a-graph" style="line-height: 16px;" target="">Create a Graph</a></p> <p><br></p> <p style="text-align: center;"><a href="6000064662-circonus-terminology"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" style="text-align: center;" alt="" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040834-create-a-graph"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" style="text-align: center;" alt="" class="fr-dii fr-draggable"></a><br></p> </div></div></div></div> 6000158965 1042 6000040825 2017-09-20T14:58:23-04:00 6003235491 3 2 0 3 Create a Check 2015-09-21T08:47:20-04:00 6002695175 1 2015-08-12T08:18:29-04:00 1 0 Graphing in Circonus is completely distinct from the collection of data, which makes the system much more flexible for your needs. Instead of knowing ahead of time which graphs you’ll need or having to make complex definitions just to see data points from two different sources, Circonus makes it easy to add metrics to a graph on the fly. To get started with graph creation, go to the “Graphs” menu item and then click on “New Graph +” in the upper right. From here you can add any metrics to your graph using the checks list at the top. Once the metrics are added to the graph, you can modify them using transforms, formulas, and stacks, as well as changing the axis, color, and name. Let's look at a step-by-step walkthrough: Circonus graphs are created and managed under the "Visualize" section of the main menu.             Click on the "New Graph +" button to create a new graph. The first step of graph creation is to find and select a piece of data to visualize. So the data exploration tool is opened for new graphs:             You can unfold the tree of metrics by click on the rightward facing triangles next to the check names.             If there is only one child in the tree, it will auto-expand to the next level for your convenience. Notice the "drag & drop to sort" text at the top. This allows you to "re-hang" the tree based on different information. By default, the tree shows "Check", Check "Type", "Broker", "Host", and finally "Metric". Depending on the task at hand, you may find it easier to use a different order for hanging the tree. Just drag the title labels to the left or right to change how the data is organized.             Click the "Add" label next to the name of the metric to add that metric to the current graph. Once added, the metric will appear in the list with a star next to it.             Scrolling down will show the graph that you are currently constructing:            You can continue to search for datapoints and add them to your graph. When finished, click on the title of the graph to change the default title, and hit Enter/Return when complete. To prevent accidental duplication, users are prevented from creating graphs with the same name as existing graphs.             Click "Save" to save your graph. The page will reload. It will still be in edit mode, but with an indicator that the graph has been saved. As you work with the graph going forward, there is no reason to explicitly save the graph because Circonus will automatically save your changes as you work. At this point, you may add a description to your graph if you wish. To open the editing dialog, click the "Edit Description" button. whenever there isn't enough room to show the description, such as some cases where the graph is shown in smaller form across the app, you will see a circular information icon containing the description as a tooltip.             You can also watch a short video process here: Creating a Graph Next Step: Create an Alert <div dir="ltr"><div dir="ltr"><div dir="ltr"> <p style="text-align: center;"><a href="6000040825-create-a-check"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" style="text-align: center;" alt="" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040841-create-an-alert"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" style="text-align: center; height: 60px;" data-height="60" alt="" class="fr-dii fr-draggable"></a><span><br></span></p> <p><span><br></span></p> <p><span>Graphing in Circonus is completely distinct from the collection of data, which makes the system much more flexible for your needs. Instead of knowing ahead of time which graphs you’ll need or having to make complex definitions just to see data points from two different sources, Circonus makes it easy to add metrics to a graph on the fly.</span></p> <p><br></p> <p>To get started with graph creation, go to the “Graphs” menu item and then click on “New Graph +” in the upper right. From here you can add any metrics to your graph using the checks list at the top. Once the metrics are added to the graph, you can modify them using transforms, formulas, and stacks, as well as changing the axis, color, and name.</p> <p><br></p> <p>Let's look at a step-by-step walkthrough:</p> <ol> <li> <span>Circonus graphs are created and managed under the "Visualize" section of the main menu.</span><span><br><p>           <img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003710514/original/Mainmenu_graphs.png?1440200014" class="inline-image fr-dii fr-draggable" data-id="6003710514" style="cursor: default; height: 360px;" data-height="360"></p></span> </li> <li>Click on the "New Graph +" button to create a new graph.<br> </li> <li>The first step of graph creation is to find and select a piece of data to visualize. So the data exploration tool is opened for new graphs:<br><span>           </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003708408/original/graph_data_selection2.png?1440193435" class="inline-image fr-dii fr-draggable" data-id="6003708408" style="cursor: default; width: 807.039px; height: 417px;" data-height="417"> </li> <li>You can unfold the tree of metrics by click on the rightward facing triangles next to the check names.<br>           <img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003708479/original/metric_tree.png?1440193592" class="inline-image fr-dii fr-draggable" data-id="6003708479" style="cursor: default; width: 339.808px; height: 299px;" data-height="299"><br><br>If there is only one child in the tree, it will auto-expand to the next level for your convenience. Notice the "drag &amp; drop to sort" text at the top. This allows you to "re-hang" the tree based on different information. By default, the tree shows "Check", Check "Type", "Broker", "Host", and finally "Metric". Depending on the task at hand, you may find it easier to use a different order for hanging the tree. Just drag the title labels to the left or right to change how the data is organized.<br><span>           </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003708488/original/metric_tree_which.png?1440193605" class="inline-image fr-dii fr-draggable" data-id="6003708488" style="cursor: default; width: 347.764px; height: 306px;" data-height="306"> </li> <li>Click the "Add" label next to the name of the metric to add that metric to the current graph. Once added, the metric will appear in the list with a star next to it.<br><span>           </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003708495/original/metric_added.png?1440193623" class="inline-image fr-dii fr-draggable" data-id="6003708495" style="cursor: default;"> </li> <li> <span>Scrolling down will show the graph that you are currently constructing:<br></span><span>          </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003711120/original/initial_graph2.png?1440202291" class="inline-image fr-dii fr-draggable" data-id="6003711120" style="cursor: default; width: 819.988px; height: 473px;" data-height="473"> </li> <li><span>You can continue to search for datapoints and add them to your graph.</span></li> <li> <span>When finished, click on the title of the graph to change the default title, and hit Enter/Return when complete. </span>To prevent accidental duplication, users are prevented from creating graphs with the same name as existing graphs.<br><span>           </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003711122/original/saved_graph2.png?1440202303" class="inline-image fr-dii fr-draggable" data-id="6003711122" style="cursor: default; width: 788.165px; height: 411px;" data-height="411"> </li> <li>Click "Save" to save your graph. The page will reload. It will still be in edit mode, but with an indicator that the graph has been saved. <span>As you work with the graph going forward, there is no reason to explicitly save the graph because Circonus will automatically save your changes as you work.</span> </li> <li>At this point, you may add a description to your graph if you wish. To open the editing dialog, click the "Edit Description" button. <span>whenever there isn't enough room to show the description, such as some cases w</span><span>here the graph is shown in smaller form across the app, you will see a circular information icon containing the description as a tooltip.</span><br><p>           <img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003711133/original/graph_edit_datapoint_rename2.png?1440202361" class="inline-image fr-dii fr-draggable" data-id="6003711133" style="cursor: default; height: 412px; width: 792.384px;" data-height="412"></p> </li> </ol> <p><br></p> <p>You can also watch a short video process here: <a href="https://www.youtube.com/watch?v=TDP-8gdqgns" style="line-height: 16px;" target="_blank">Creating a Graph</a></p> <p><br></p> <div style="text-align: center;"><span class="fr-video fr-dvi fr-draggable" style=""><iframe width="560" height="315" src="https://www.youtube.com/embed/TDP-8gdqgns" frameborder="0" allowfullscreen="" style="text-align: initial; line-height: 16px;" sandbox="allow-scripts allow-forms allow-same-origin allow-presentation"></iframe></span></div> <p><br></p> <p>Next Step: <a href="6000040841-create-an-alert" style="line-height: 16px;" target="">Create an Alert</a></p> <p><br></p> <p style="text-align: center;"><a href="6000040825-create-a-check" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040841-create-an-alert" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" data-height="60" alt="" style="font-size: 13px; height: 60px;" class="fr-dii fr-draggable"></a><br></p> </div></div></div> 6000158965 592 6000040834 2017-09-20T14:57:12-04:00 6003235491 4 2 1 0 Create a Graph 2015-09-21T08:47:20-04:00 6002695175 1 2015-08-12T08:33:08-04:00 0 0 Circonus has the ability to create alerts for you based on defined rulesets. These rulesets allow you to set up thresholds that will trigger different severities of alerts. Once you’ve set up a ruleset, you can add a contact group to that ruleset, so you can be notified via email, SMS, Jabber, IRC, Pagerduty, or one or more of many other methods. Alerts are triggered when metric values violate a rule configured in the system. To create an alert, you must create a ruleset. Start by adding a rule to a one your check's metrics: Select a check from the "Checks" page, and click on the down arrow in the rightmost column to expand the selected check:             Now click "View Check Details" from this expanded view to open the check view page:             From the check view page, you can now select a metric from the list of metrics for that check and click the down arrow to expand details for that metric:             Click "Set Rules" to open the "Rulesets" page with information for this metric.             From the Rulesets page, you can add new rules. This is also the same interface you will use when editing an existing ruleset, and it can also be accessed under the "Monitor" section of the main menu.. Rules are created on individual metrics. You may configure more than one rule per metric, this is your ruleset. Rules are processed in order, and the first one to be found in violation triggers the alert and rule processing stops. Click the "Add Rule +" to open a menu:             There are fore items you can change on the "Add a Rule" dialog: The first select box is the rule to evaluate. Here we selected "is present and higher than" to compare our incoming value with the value we provide in the next box. The text input field lets you enter the value with which you want to compare the metric. For example, we could say we want to be alerted if our duration exceeds 100ms. Next we select what severity level this rule will trigger. Circonus has 5 severity levels, 1 through 5, with 1 being the most severe. The last field lets us add a wait time. Circonus will create the alert in the UI immediately when a rule is violated, but it will wait the specified number of minutes before notifying any contact groups about the problem. This allows time for the issue to resolve on its own. Once you have configured your new rule, click "Add". Click the "Add Contact +" button to attach a contact group to be notified when an alert is triggered.             From the "Add a Contact Group" dialog, simply select the name of the contact group you want to notify, and then select which severity levels they will be alerted about. You can have any number of groups attached to a ruleset, being notified about any number of severities. If you do not want to attach a group, the alert will still be created for you to see in the UI.             Finally, note the "Metric Notes" section of the "Rulesets" page. We provide some brief detail about why this rule might alert, and a link to an internal wiki on how to resolve it. These notes and links will show up on the alerts in the UI, and the links are sent along with notifications to contact groups.             The are several other ruleset options that you can implement from this page: Latest Value - The value we last saw flow into the system for this metric. Derivative - If you want your rules to operate on the first order derivative, you can set this value to "derive" or "counter". Derivatives can become negative, while counters can handle rollover. Depends On - Dependencies let us create parent-child relationships with metrics. Establishing metric dependencies allows you to say "If the parent metric is in alert, don't tell me the child is also in alert." This prevents you from receiving redundant alerts. Circonus assumes a severity 1 alert to mean that the host is "down," so you can only create dependencies on metrics that have at least one severity 1 rule configured. Setting the parent is as simple as selecting a metric from the list. The system automatically saves this value when you change it. For example, here we have set our duration metric to depend on the HTTP status code because if we aren't serving a 200, then we don't care that our duration is too high. Metric Notes - You can create notes to give details on why this metric might trigger an alert. You might also provide a link to additional documentation detailing remediation actions. This is highly recommended. You can watch a short video of the process here: Creating a Ruleset You can also learn more about Analytics Alerts here. Next Step: Using Analytics to Better Understand Your Data <div dir="ltr"><div dir="ltr"><div dir="ltr"> <p style="text-align: center;"><a href="6000040834-create-a-graph"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" style="text-align: center;" alt="" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040847-apply-analytics-overlays-"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" style="text-align: center; width: 100px; height: 60px;" data-height="60" alt="" class="fr-dii fr-draggable"></a><span><br></span></p> <p><span><br></span></p> <p><span>Circonus has the ability to create alerts for you based on defined rulesets. These rulesets allow you to set up thresholds that will trigger different severities of alerts. Once you’ve set up a ruleset, you can add a contact group to that ruleset, so you can be notified via email, SMS, Jabber, IRC, Pagerduty, or one or more of many other methods.</span><br></p> <p><br></p> <p>Alerts are triggered when metric values violate a rule configured in the system. To create an alert, you must create a ruleset. Start by adding a rule to a one your check's metrics:<br></p> <ol> <li> <span>Select a check from the "Checks" page, and click on the down arrow in the rightmost column to expand the selected check:<br>           </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003743491/original/Alerts1.png?1440369782" class="inline-image fr-dii fr-draggable" data-id="6003743491" style="cursor: default; width: 774.129px; height: 400px;" data-height="400"> </li> <li><span>Now click "View Check Details" from this expanded view to open the check view page:<br><p><span style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 13px;">           </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003743490/original/Alerts2.png?1440369773" class="inline-image fr-dii fr-draggable" data-id="6003743490" style="cursor: default; width: 773.976px; height: 400px;" data-height="400"></p></span></li> <li><span>From the check view page, you can now select a metric from the list of metrics for that check and click the down arrow to expand details for that metric:<br><p><span style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 13px;">           </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003743489/original/Alerts3.png?1440369765" class="inline-image fr-dii fr-draggable" data-id="6003743489" style="cursor: default; width: 774.038px; height: 400px;" data-height="400"></p></span></li> <li><span>Click "Set Rules" to open the "Rulesets" page with information for this metric.<br><p><span style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 13px;">           </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003743488/original/Alerts4.png?1440369756" class="inline-image fr-dii fr-draggable" data-id="6003743488" style="cursor: default; width: 773.976px; height: 400px;" data-height="400"></p></span></li> <li><span>From the Rulesets page, you can add new rules. T<span>his is also the same interface you will use when editing an existing ruleset, and it<span> can also be accessed under the "Monitor" section of the main menu.</span><span>.</span><span> </span><span>Rules are created on individual metrics. You may configure more than one rule per metric, this is your ruleset. Rules are processed in order, and the first one to be found in violation triggers the alert and rule processing stops.</span><span> Click the "Add Rule +" to open a menu:</span><br></span><p><span style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 13px;">           </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003743486/original/Alerts5.png?1440369748" class="inline-image fr-dii fr-draggable" data-id="6003743486" style="cursor: default; width: 774.038px; height: 400px;" data-height="400"></p></span></li> <li> <span>There are fore items you can change on the "Add a Rule" dialog:</span><ol> <li>The first select box is the rule to evaluate. Here we selected "is present and higher than" to compare our incoming value with the value we provide in the next box.</li> <li>The text input field lets you enter the value with which you want to compare the metric. For example, we could say we want to be alerted if our duration exceeds 100ms.</li> <li>Next we select what severity level this rule will trigger. Circonus has 5 severity levels, 1 through 5, with 1 being the most severe.</li> <li>The last field lets us add a wait time. Circonus will create the alert in the UI immediately when a rule is violated, but it will wait the specified number of minutes before notifying any contact groups about the problem. This allows time for the issue to resolve on its own.<br><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003747461/original/Alerts6.png?1440383594" class="inline-image fr-dii fr-draggable" data-id="6003747461" style="cursor: default;"> </li> </ol> </li> <li><span>Once you have configured your new rule, click "Add".</span></li> <li> <span>Click the "Add Contact +" button to attach a contact group to be notified when an alert is triggered.<br></span><span>           </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003747544/original/Alerts7.png?1440383743" class="inline-image fr-dii fr-draggable" data-id="6003747544" data-height="398" style="cursor: default; height: 398px; width: 769.33px;"> </li> <li> <span>From the "Add a Contact Group" dialog, simply select the name of the contact group you want to notify, and then select which severity levels they will be alerted about. You can have any number of groups attached to a ruleset, being notified about any number of severities. If you do not want to attach a group, the alert will still be created for you to see in the UI.<br></span><span>           </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003747587/original/Alerts8.png?1440383874" class="inline-image fr-dii fr-draggable" data-id="6003747587" style="cursor: default;"> </li> <li>Finally, note the "Metric Notes" section of the "Rulesets" page. We provide some brief detail about why this rule might alert, and a link to an internal wiki on how to resolve it. These notes and links will show up on the alerts in the UI, and the links are sent along with notifications to contact groups.<br>           <img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6003749709/original/Alerts9.png?1440388917" class="inline-image fr-dii fr-draggable" data-id="6003749709" data-height="393" style="cursor: default; height: 393px; width: 759.098px;"> </li> </ol> <p><br>The are several other ruleset options that you can implement from this page:</p> <ol> <li>Latest Value - The value we last saw flow into the system for this metric.<br><br> </li> <li><span style="font-size: 13px;">Derivative - If you want your rules to operate on the first order derivative, you can set this value to "derive" or "counter". Derivatives can become negative, while counters can handle rollover.<br><br></span></li> <li> <span>Depends On - Dependencies let us create parent-child relationships with metrics. </span><span>Establishing metric dependencies allows you to say "If the parent metric is in alert, don't tell me the child is also in alert." This prevents you from receiving redundant alerts. Circonus assumes a severity 1 alert to mean that the host is "down," so you can only create dependencies on metrics that have at least one severity 1 rule configured. Setting the parent is as simple as selecting a metric from the list. The system automatically saves this value when you change it. For example, here we have set our duration metric to depend on the HTTP status code because if we aren't serving a 200, then we don't care that our duration is too high.<br><br></span> </li> <li><span>Metric Notes - You can create notes to give details on why this metric might trigger an alert. You might also provide a link to additional documentation detailing remediation actions. This is highly recommended.</span></li> </ol> <p><br></p> <p>You can watch a short video of the process here: <a href="https://www.youtube.com/watch?v=v8z64oNBcOg" style="line-height: 16px;" target="_blank">Creating a Ruleset</a></p> <p><br></p> <div style="text-align: center;"><span class="fr-video fr-dvi fr-draggable" style=""><iframe width="560" height="315" src="https://www.youtube.com/embed/v8z64oNBcOg" frameborder="0" allowfullscreen="" style="text-align: initial; line-height: 16px;" sandbox="allow-scripts allow-forms allow-same-origin allow-presentation"></iframe></span></div> <p><br></p> <p>You can also learn more about <a href="6000112370-analytics-alerting-tutorial-and-use-cases" target="">Analytics Alerts here</a>.</p> <p><br></p> <p>Next Step: <a href="6000040847-apply-analytics-overlays-" style="line-height: 16px;" target="">Using Analytics to Better Understand Your Data</a></p> <p><br></p> <p style="text-align: center;"><a href="6000040834-create-a-graph" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040847-apply-analytics-overlays-" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" data-height="60" alt="" style="font-size: 13px; width: 100px; height: 60px;" class="fr-dii fr-draggable"></a><br></p> </div></div></div> 6000158965 548 6000040841 2017-09-20T14:55:09-04:00 6003235491 5 2 0 0 Create an Alert 2015-09-21T08:47:20-04:00 6002695175 1 2015-08-12T08:48:38-04:00 0 0 Circonus doesn’t ever roll-up or aggregate any of your data, so you can do some interesting real-time analytics. The “+” button in the upper-right corner of any graph lets you add overlays for data analysis to the graph you are viewing. There are overlays for showing historical data, comparisons with other graphs, identifying anomalies, or extrapolating into the future. For instance, if you have a graph of disk space utilization on a server, it may be growing at a fairly consistent, yet slow pace. Adding a Linear Regression overlay to this data can show the trend of your current usage. If you expand the time frame for your graph into the future, the Linear Regression overlay will predict when you’ll hit your limit for disk space, allowing you to plan your capacity before you need it. Let's look at a simple example of how to add an overlay to an existing graph to compare it with historical data: Open the graph to which you would like to add an overlay. Click the "+" button in the upper-right corner. This will display the "Add Data Overlay" menu.       There are tabs for several categories of overlays; Capacity Planning, Anomaly Detection, Service Level Monitoring (which handles percentiles), Graph Comparison, and Other Analytics. For this example, we'll use the Graph Comparison tab.                               The Graph Comparison tab can also be used to overlay other graphs from this account, but for this example, we're going to make an overlay of the current graph. "Current Graph" is the default option in the graph field. When comparing the current graph with itself, the x axis can be shifted to show a prior time frame and the Y axis can optionally be locked to the main graph’s Y axis. For this example, we'll compare the graph to data from the previous week. Note the drop down menus for "Shift the x axis to show" and "Lock this graph's Y axis to the main graph's Y axis:" We will set the first drop down to "1 week prior" and the second drop down to "Yes". Once you've made your selections, click the "Add Overlay" button. The original graph now has the comparison graph overlayed over it. Notice the tabs at the top of the graph and the new information in the legend. Once an overlay has been added to a graph, tabs will appear directly above the graph indicating each of the overlays added. You can drag-and-drop the tabs to reorder them.       The legend has titles that include both the date (useful for understanding time comparisons) and the tab letter indicator (A, B, C, etc.). This helps keep the frame of reference so we know which column is which. As you hover, the legend automatically updates the current values with an additional indicator describing the variance between the two graphs for each corresponding data point. An icon pointing up or down indicates if the value is above or below the reference value. A percentage difference is available below the icon. The intensity of the arrow will change (becoming darker or lighter) as the difference increases or decreases. The graphs are overlaid from left to right (B "on top of" A and so on). This means that the right-most tab will be the clearest graph and each subsequent graph "underneath" it will be faded. To pull graph data to the front, you can hover over a tab and it will intensify just that overlay. A graph overlay or a set of overlays can be saved to quickly recall it later. Click on the menu button next to the plus button to manage your overlay sets. Name the overlay and click the "Save" button:       Once an Overlay Set has been saved, it can be recalled at any time by clicking on the menu icon and selecting it from the list of existing sets. Just click "view" to recall your saved overlays.       For more information about Analytics, refer to the User Documentation for Graph Overlays and Analytics Overlays. Next Step: Create a Dashboard <div dir="ltr"><div dir="ltr"> <p style="text-align: center;"><a href="6000040841-create-an-alert"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" style="text-align: center;" alt="" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040875-create-a-dashboard"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" style="text-align: center; width: 100px; height: 60px;" data-height="60" alt="" class="fr-dii fr-draggable"></a><span><br></span></p> <p><span><br></span></p> <p><span>Circonus doesn’t ever roll-up or aggregate any of your data, so you can do some interesting real-time analytics. The “+” button in the upper-right corner of any graph lets you add overlays for data analysis to the graph you are viewing. There are overlays for showing historical data, comparisons with other graphs, identifying anomalies, or extrapolating into the future.</span></p> <p><br></p> <p>For instance, if you have a graph of disk space utilization on a server, it may be growing at a fairly consistent, yet slow pace. Adding a Linear Regression overlay to this data can show the trend of your current usage. If you expand the time frame for your graph into the future, the Linear Regression overlay will predict when you’ll hit your limit for disk space, allowing you to plan your capacity before you need it.</p> <p><br></p> <p>Let's look at a simple example of how to add an overlay to an existing graph to compare it with historical data:</p> <ol> <li>Open the graph to which you would like to add an overlay.<br><br> </li> <li> <span>Click the "+" button in the upper-right corner. This will display the "Add Data Overlay" menu.<br>     </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012504659/original/blob1451863246804.png?1451863203" class="inline-image fr-dii fr-draggable" data-id="6012504659" data-height="306" style="width: 753.78px; height: 306px;"> </li> <li> <span>There are tabs for several categories of overlays; Capacity Planning, Anomaly Detection, Service Level Monitoring (which handles percentiles), Graph Comparison, and Other Analytics. For this example, we'll use the Graph Comparison tab.<br></span><span>                             </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012506055/original/blob1451867496754.png?1451867453" class="inline-image fr-dii fr-draggable" data-id="6012506055"> </li> <li><span><p><span>The Graph Comparison tab can also be used to overlay other graphs from this account, but for this example, we're going to make an overlay of the current graph. "Current Graph" is the default option in the graph field.<br><br></span></p></span></li> <li><p><span>When comparing the current graph with itself, the x axis can be shifted to show a prior time frame and the Y axis can optionally be locked to the main graph’s Y axis. For this example, we'll compare the graph to data from the previous week. </span><span>Note the drop down menus for "Shift the x axis to show" and "Lock this graph's</span><span> Y axis to the main graph's Y axis:" We will set the first drop down to "1 week prior" and the second drop down to "Yes".<br><br></span></p></li> <li><span>Once you've made your selections, click the "Add Overlay" button.<br><br></span></li> <li> <span>The original graph now has the comparison graph overlayed over it. Notice the tabs at the top of the graph and the new information in the legend. <span>Once an overlay has been added to a graph, tabs will appear directly above the graph indicating each of the overlays added. You can drag-and-drop the tabs to reorder them.</span><br></span><span>     </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012504973/original/blob1451864345076.png?1451864302" class="inline-image fr-dii fr-draggable" data-id="6012504973" data-height="310" style="width: 758.997px; height: 310px;"><br>The legend has titles that include both the date (useful for understanding time comparisons) and the tab letter indicator (A, B, C, etc.). This helps keep the frame of reference so we know which column is which.<br><br><span>As you hover, the legend automatically updates the current values with an additional indicator describing the variance between the two graphs for each corresponding data point. An icon pointing up or down indicates if the value is above or below the reference value. A percentage difference is available below the icon. The intensity of the arrow will change (becoming darker or lighter) as the difference increases or decreases.<br></span><span><br>The graphs are overlaid from left to right (B "on top of" A and so on). This means that the right-most tab will be the clearest graph and each subsequent graph "underneath" it will be faded. To pull graph data to the front, you can hover over a tab and it will intensify just that overlay.<br><br></span> </li> <li>A graph overlay or a set of overlays can be saved to quickly recall it later. Click on the menu button next to the plus button to manage your overlay sets.<br><br> </li> <li>Name the overlay and click the "Save" button:<br><span>     </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012505146/original/blob1451864916185.png?1451864873" class="inline-image fr-dii fr-draggable" data-id="6012505146" data-height="253" style="width: 753.794px; height: 253px;"> </li> <li> <span>Once an Overlay Set has been saved, it can be recalled at any time by clicking on the menu icon and selecting it from the list of existing sets. Just click "view" to recall your saved overlays.<br></span><span>     </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012505150/original/blob1451864948669.png?1451864905" class="inline-image fr-dii fr-draggable" data-id="6012505150" data-height="252" style="width: 752.374px; height: 252px;"> </li> </ol> <p><br></p> <p>For more information about Analytics, refer to the <a href="https://login.circonus.com/user/docs/Visualization/Graphs/View/Overlays" target="">User Documentation for Graph Overlays</a> and <a href="https://login.circonus.com/user/docs/Visualization/Graphs/View/Overlays/Analytics" target="">Analytics Overlays</a>.</p> <p><br></p> <p>Next Step: <a href="6000040875-create-a-dashboard" style="line-height: 16px;" target="">Create a Dashboard</a></p> <p><br></p> <p style="text-align: center;"><a href="6000040841-create-an-alert" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040875-create-a-dashboard" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" data-height="60" alt="" style="font-size: 13px; width: 100px; height: 60px;" class="fr-dii fr-draggable"></a><br></p> </div></div> 6000158965 275 6000040847 2017-09-20T14:54:16-04:00 6003235491 6 2 0 0 Apply Analytics (Overlays) 2015-09-21T08:47:21-04:00 6002695175 1 2015-08-12T09:35:30-04:00 0 1 Looking at a graph is very useful for digging in to a specific metric. Sometimes, you want to see many metrics at once, all streaming into your browser in real-time. Circonus dashboards allow you to add various visualization widgets, such as dials, graphs, alerts, and charts. Dashboards can be shared with your team or kept private. You can watch a video overview of dashboards here: Dashboards - An Overview. To create a custom Dashboard, go to the "Dashboards" page in the UI under the "Visualize" section in the main menu. From here you can see the list of dashboards you created and any dashboards that have been shared by others.       Click the "New Dashboard +" button. You will be presented with a panel with various options for beginning your dashboard. You can choose between predefined layouts, such as the 4x4 or 8x8 blank grid, or if you have created other dashboards already, you can select a previous layout. For this example, we will assume you started with a blank 4x4 layout.     On the edit page that opens, a panel of widgets will drop down. Each widget has different uses and options from which to choose. They can be added to the dashboard by drag and drop, or by clicking an empty cell and then clicking the widget.       Each widget can be resized by clicking and dragging the lower right corner and they can be moved to new positions by dragging. There is an X in the upper right to remove them from the dashboard, or a set of gears to configure what data they will show. Each widget type has different configuration options.           For more information on Dashboards and the various visualization widgets available, refer to the User Documentation on Dashboards. Next Step: Tags <div dir="ltr"><div dir="ltr"><div dir="ltr"> <p style="text-align: center;"><a href="6000040847-apply-analytics-overlays-"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" style="text-align: center;" alt="" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040884-tags"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" style="text-align: center; width: 100px; height: 60px;" data-height="60" alt="" class="fr-dii fr-draggable"></a><span><br></span></p> <p><span><br></span></p> <p><span>Looking at a graph is very useful for digging in to a specific metric. Sometimes, you want to see many metrics at once, all streaming into your browser in real-time. Circonus dashboards allow you to add various visualization widgets, such as dials, graphs, alerts, and charts. Dashboards can be shared with your team or kept private.</span></p> <p><br></p> <p>You can watch a video overview of dashboards here: <a href="https://www.youtube.com/watch?v=2T6Gz32qVa4" style="line-height: 16px; background-color: rgb(255, 255, 255);" target="_blank">Dashboards - An Overview</a>.<br></p> <p><br></p> <ol> <li> <span>To create a custom Dashboard, go to the "Dashboards" page in the UI under the "Visualize" section in the main menu. From here you can see the list of dashboards you created and any dashboards that have been shared by others.<br></span>     <img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012510030/original/blob1451876746800.png?1451876703" class="inline-image fr-dii fr-draggable" data-id="6012510030" data-height="513" style="width: 765.809px; height: 513px;"> </li> <li> <span>Click the "New Dashboard +" button.<br></span><br> </li> <li> <span>You will be presented with a panel with various options for beginning your dashboard. You can choose between predefined layouts, such as the 4x4 or 8x8 blank grid, or if you have created other dashboards already, you can select a previous layout. For this example, we will assume you started with a blank 4x4 layout.<br></span>    <img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012510019/original/blob1451876732219.png?1451876688" class="inline-image fr-dii fr-draggable" data-id="6012510019" data-height="372" style="width: 769.975px; height: 372px;"> </li> <li> <span>On the edit page that opens, a panel of widgets will drop down. Each widget has different uses and options from which to choose. They can be added to the dashboard by drag and drop, or by clicking an empty cell and then clicking the widget.<br></span>     <img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012509999/original/blob1451876721689.png?1451876678" class="inline-image fr-dii fr-draggable" data-id="6012509999" data-height="516" style="width: 766.154px; height: 516px;"> </li> <li> <span>Each widget can be resized by clicking and dragging the lower right corner and they can be moved to new positions by dragging. There is an X in the </span><span>upper right to remove them from the dashboard, or a set of gears to configure what data they will show. Each widget type has different configuration options.<br></span>         <img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012509994/original/blob1451876710546.png?1451876667" class="inline-image fr-dii fr-draggable" data-id="6012509994"> </li> </ol> <p><br></p> <p><br></p> <p>For more information on Dashboards and the various visualization widgets available, refer to the <a href="https://login.circonus.com/user/docs/Dashboards" target="">User Documentation on Dashboards</a>.</p> <p><br></p> <p>Next Step: <a href="6000040884-tags" style="line-height: 16px;" target="">Tags</a></p> <p><br></p> <p style="text-align: center;"><a href="6000040847-apply-analytics-overlays-" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040884-tags" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" data-height="60" alt="" style="font-size: 13px; width: 100px; height: 60px;" class="fr-dii fr-draggable"></a></p> </div></div></div> 6000158965 242 6000040875 2017-09-20T14:56:09-04:00 6003235491 7 2 0 1 Create a Dashboard 2015-09-21T08:47:21-04:00 6002695175 1 2015-08-12T09:45:15-04:00 0 0 Tags in Circonus behave very similarly to Gmail labels. You can create new tags on-the-fly, filter based on tags, and add multiple tags to the same item. The great thing about tags is that you can use them in whatever way makes sense for your needs. Tags can help you organize your data so you can show: The applications that are running on a system The client or customer to whom the data is relevant The dashboard or worksheet for which a graph might be used The internal data center, subnet, or domain of which the system is a part The internal group that is responsible for the data Any Chef, Puppet, or Ansible related information The type of information (network, storage, application, etc.) You can have tags on checks (useful for getting data via the API or filtering the checks/hosts page in the UI), on graphs (useful for displaying only certain graphs or for making worksheets), and on rulesets (useful if you send the alerts via webhooks to something like Hipchat or Splunk/Logstash). Having tags on any given item means you can do things like "show all graphs for disk usage in datacenterB of servers running MySQL" or "get all checks via the API that are SNMP for switches that pertain to customer 3 so I can add a new metric to those checks." For more information on using tags, refer to the User Documentation for Tags and Tag Filters. Next Step: Metric Clusters <div dir="ltr"><div dir="ltr"> <p style="text-align: center;"><a href="6000040875-create-a-dashboard"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" style="text-align: center;" alt="" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040888-metric-clusters"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" style="text-align: center;" alt="" class="fr-dii fr-draggable"></a><span><br></span></p> <p><span><br></span></p> <p><span>Tags in Circonus behave very similarly to Gmail labels. You can create new tags on-the-fly, filter based on tags, and add multiple tags to the same item. The great thing about tags is that you can use them in whatever way makes sense for your needs. Tags can help you organize your data so you can show:</span></p> <ul> <li>The applications that are running on a system</li> <li>The client or customer to whom the data is relevant</li> <li>The dashboard or worksheet for which a graph might be used</li> <li>The internal data center, subnet, or domain of which the system is a part</li> <li>The internal group that is responsible for the data</li> <li>Any Chef, Puppet, or Ansible related information</li> <li>The type of information (network, storage, application, etc.)</li> </ul> <p>You can have tags on checks (useful for getting data via the API or filtering the checks/hosts page in the UI), on graphs (useful for displaying only certain graphs or for making worksheets), and on rulesets (useful if you send the alerts via webhooks to something like Hipchat or Splunk/Logstash).</p> <p><br></p> <p>Having tags on any given item means you can do things like "show all graphs for disk usage in datacenterB of servers running MySQL" or "get all checks via the API that are SNMP for switches that pertain to customer 3 so I can add a new metric to those checks."</p> <p><br></p> <p><br></p> <p><br></p> <p>For more information on using tags, refer to the <a href="https://login.circonus.com/user/docs/Tags" style="line-height: 16px;" target="_blank">User Documentation for Tags</a> and <a href="https://login.circonus.com/user/docs/Tags/TagFilters" target="">Tag Filters</a>.</p> <p><br></p> <p>Next Step: <a href="6000040888-metric-clusters" style="line-height: 16px;" target="">Metric Clusters</a></p> <p><br></p> <p style="text-align: center;"><a href="6000040875-create-a-dashboard" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040888-metric-clusters" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a><br></p> </div></div> 6000158965 160 6000040884 2017-09-20T14:51:59-04:00 6003235491 8 2 0 0 Tags 2015-09-21T08:47:21-04:00 6002695175 1 2015-08-12T09:47:41-04:00 2 0 Metric Clusters help with dynamic environments. This feature allows you to save a search query, such as "5minLoadAverage". You can then see a list of the metrics that match that query, see how they compare to each other, and graph that cluster. To set up a cluster, go to the "Metric Clusters" page in the UI under the "Collect" section in the main menu.       Click the "New Cluster +" button in the upper right.           Once you name your cluster, you can add a query to the cluster to search for the metrics, then save the query. Select your cluster from list to view details:       If you want to graph that cluster, you can make a new graph on the "Graphs" page under the "Visualize" section of the main menu, then click the "Metric Cluster +" button in the upper right of the graph edit page.  Once you create a graph that's attached to a metric cluster, the graph will always show all of the members of that cluster. As new metrics are added to Circonus, you will see them show up in the graph automatically. For more information on using Metric Clusters, refer to the User Documentation for Metric Clusters. Next Step: Templates <div dir="ltr"><div dir="ltr"> <p style="text-align: center;"><a href="6000040884-tags"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" style="text-align: center;" alt="" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040889-templates"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" style="text-align: center;" alt="" class="fr-dii fr-draggable"></a><span><br></span></p> <p><span><br></span></p> <p><span>Metric Clusters help with dynamic environments. This feature allows you to save a search query, such as "5minLoadAverage". You can then see a list of the metrics that match that query, see how they compare to each other, and graph that cluster.</span></p> <ol> <li> <span>To set up a cluster, go to the "Metric Clusters" page in the UI under the "Collect" section in the main menu.<br>     </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012507225/original/blob1451870461195.png?1451870417" class="inline-image fr-dii fr-draggable" data-id="6012507225" data-height="183" style="width: 759.697px; height: 183px;"> </li> <li> <span>Click the "New Cluster +" button in the upper right.<br></span>          <img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012507231/original/blob1451870481803.png?1451870438" class="inline-image fr-dii fr-draggable" data-id="6012507231"> </li> <li> <span>Once you name your cluster, you can add a query to the cluster to search for the metrics, then save the que</span><span>ry.<br></span><br> </li> <li> <span>Select your cluster from list to view details:<br>     </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012507243/original/blob1451870499471.png?1451870456" class="inline-image fr-dii fr-draggable" data-id="6012507243" data-height="516" style="width: 755.709px; height: 516px;"> </li> <li> <span>If you want to graph that cluster, you can make a new graph on the "Graphs" page under the "Visualize" section of the main menu, then click the "Metric Cluster +" button in the upper right of the graph edit page. </span><br> </li> </ol> <p><br></p> <p>Once you create a graph that's attached to a metric cluster, the graph will always show all of the members of that cluster. As new metrics are added to Circonus, you will see them show up in the graph automatically.</p> <p><br></p> <p><br></p> <p><span>For more information on using Metric Clusters, refer to the </span><a href="https://login.circonus.com/user/docs/Data/View/MetricClusters" style="line-height: 16px;" target="_blank">User Documentation for Metric Clusters</a>.</p> <p><br></p> <p>Next Step: <a href="6000040889-templates" style="line-height: 16px;" target="">Templates</a></p> <p><br></p> <p style="text-align: center;"><a href="6000040884-tags" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040889-templates" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a><br></p> </div></div> 6000158965 236 6000040888 2017-09-20T14:51:06-04:00 6003235491 9 2 2 0 Metric Clusters 2015-09-21T08:47:21-04:00 6002695175 1 2015-08-12T09:49:57-04:00 0 0 If you need to provision the same check across a list of hosts, templates can help you accomplish that. To start using templates, you’ll have to have checks created that will serve as the "master" for the template. Add these to a new template, then provide a list of hosts for which you would like to start collecting data. These templates can also have rulesets associated with them, which lets you quickly expand your cluster or infrastructure without having to reinvent the wheel. To set up a template, go to the "Templates" page in the UI under the "Collect" section in the main menu.       The "New Template +" button will provide a dialog to create a new template based on the checks from a current host in the system.            Begin typing the name of a host in the "Master Host:" field and Circonus will automatically search for and suggest a host in the system to match the entered text.           Completing this dialog will result in a new blank template.       Unfolding this template provides the ability to add checks from the selected master host and target hosts to which the template shall be applied. Click the "Add Host +" button to open a dialog, as shown below:           Enter a new host, select one or more hosts form the list, or filter the list to find an existing host in the list. Click the "Add Bundle +" button to open a dialog, as shown below:           The check bundles can be renamed in click-to-edit fashion using {target} as an interpolated variable. For example, if the check bundle is renamed to "{target} http", once it is applied to the target host "foo.com", then the resulting check in the template will be named "foo.com http", as shown below:       If the "Include Rulesets" option is checked, all the rulesets on the master Check Bundles will be copied to the Target Hosts' Check Bundles when the template is applied or re-synced. For more information on using templates, refer to the User Documentation for Templates. Next Step: API <div dir="ltr"><div dir="ltr"> <p style="text-align: center;"><a href="6000040888-metric-clusters"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" style="text-align: center; width: 100px; height: 60px;" data-height="60" alt="" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040895-api"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" style="text-align: center;" alt="" class="fr-dii fr-draggable"></a><span><br></span></p> <p><br></p> <p><span>If you need to provision the same check across a list of hosts, templates can help you accomplish that. To start using templates, you’ll have to have checks created that will serve as the "master" for the template. Add these to a new template, then provide a list of hosts for which you would like to start collecting data. These templates can also have rulesets associated with them, which lets you quickly expand your cluster or infrastructure without having to reinvent the wheel.</span></p> <ol> <li> <span>To set up a template, go to the "Templates" page in the UI under the "Collect" section in the main menu.<br></span>     <img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012508177/original/blob1451872514659.png?1451872471" class="inline-image fr-dii fr-draggable" data-id="6012508177" data-height="83" style="width: 765.444px; height: 83px;"> </li> <li> <span>The "New Template +" button will provide a dialog to create a new template based on the checks from a current host in the system.<br>          </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012508178/original/blob1451872524091.png?1451872480" class="inline-image fr-dii fr-draggable" data-id="6012508178"> </li> <li> <span>Begin typing the name of a host in the "Master Host:" field and Circonus will automatically search for and suggest a host in the system to match the entered text.<br>         </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012508182/original/blob1451872538012.png?1451872494" class="inline-image fr-dii fr-draggable" data-id="6012508182"> </li> <li> <span>Completing this dialog will result in a new blank template.<br>     </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012508189/original/blob1451872550353.png?1451872507" class="inline-image fr-dii fr-draggable" data-id="6012508189" data-height="277" style="width: 763.821px; height: 277px;"> </li> <li><span>Unfolding this template provides the ability to add checks from the selected master host and target hosts to which the template shall be applied.<br><br></span></li> <li> <span>Click the "Add Host +" button to open a dialog, as shown below:<br>         </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012508193/original/blob1451872577214.png?1451872533" class="inline-image fr-dii fr-draggable" data-id="6012508193"> </li> <li><span>Enter a new host, select one or more hosts form the list, or filter the list to find an existing host in the list.<br><br></span></li> <li> <span>Click the "Add Bundle +" button to open a dialog, as shown below:<br>         </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012508197/original/blob1451872599214.png?1451872555" class="inline-image fr-dii fr-draggable" data-id="6012508197"> </li> <li> <span>The check bundles can be renamed in click-to-edit fashion using {target} as an interpolated variable. For example, if the check bundle is renamed to "{target} http", once it is applied to the target host "foo.com", then the resulting check in the template will be named "foo.com http", as shown below:<br>     </span><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6012508200/original/blob1451872610030.png?1451872566" class="inline-image fr-dii fr-draggable" data-id="6012508200" data-height="324" style="width: 763.977px; height: 324px;"> </li> <li><span>If the "Include Rulesets" option is checked, all the rulesets on the master Check Bundles will be copied to the Target Hosts' Check Bundles when the template is applied or re-synced.</span></li> </ol> <p><br></p> <p><br></p> <p><span>For more information on using templates, refer to the </span><a href="https://login.circonus.com/user/docs/Data/Templates" style="line-height: 16px;" target="_blank">User Documentation for Templates</a>.</p> <p><br></p> <p>Next Step: <a href="6000040895-api" style="line-height: 16px;" target="">API</a></p> <p><br></p> <p style="text-align: center;"><a href="6000040888-metric-clusters" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" data-height="60" alt="" style="font-size: 13px; width: 100px; height: 60px;" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040895-api" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a><br></p> </div></div> 6000158965 127 6000040889 2017-09-20T14:50:12-04:00 6003235491 10 2 0 0 Templates 2015-09-21T08:47:21-04:00 6002695175 1 2015-08-12T09:55:07-04:00 0 0 Some users find they need to customize checks individually, but would like to do it programmatically. The Circonus API allows users to filter, sort, create, and modify any item in Circonus. Using the API allows you to convert a list of hosts with individual characteristics into a full set of checks, graphs, and rulesets with ease. The Circonus API is a REST based API. Accessing and modifying a resource is achieved by using HTTP verbs on the URL that corresponds to the Circonus ID (cid) for that resource. For more information on using the API, refer to the Circonus API Documentation. Next Steps: Additional Resources <div dir="ltr"><div dir="ltr"><div dir="ltr"> <p style="text-align: center;"><a href="6000040889-templates"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" style="text-align: center;" alt="" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040924-additional-resources"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" style="text-align: center;" alt="" class="fr-dii fr-draggable"></a><span><br></span></p> <p style="text-align: center;"><br></p> <p><span>Some users find they need to customize checks individually, but would like to do it programmatically. The Circonus API allows users to filter, sort, create, and modify any item in Circonus. Using the API allows you to convert a list of hosts with individual characteristics into a full set of checks, graphs, and rulesets with ease.</span></p> <p><br></p> <p>The Circonus API is a REST based API. Accessing and modifying a resource is achieved by using HTTP verbs on the URL that corresponds to the Circonus ID (cid) for that resource.</p> <p><br></p> <p><span>For more information on using the API, refer to the </span><a href="https://login.circonus.com/resources/api" target="_blank">Circonus API Documentation</a><span>.</span></p> <p><span><br></span></p> <p>Next Steps: <a href="6000040924-additional-resources" style="line-height: 16px;" target="">Additional Resources</a></p> <p><br></p> <p style="text-align: center;"><a href="6000040889-templates" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a> <a href="6000040924-additional-resources" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541166/original/blob1467411747860.png?1467411747" data-id="6026541166" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a><br></p> </div></div></div> 6000158965 125 6000040895 2017-09-20T14:47:56-04:00 6003235491 11 2 0 0 API 2015-09-21T08:47:22-04:00 6002695175 1 2015-08-12T10:25:45-04:00 0 1 This concludes the New User Walkthrough. We hope you have found it useful and encourage your comments and suggestions. If you need additional help as you continue to deploy Circonus, there are several additional resources you can use. Announcements Late breaking news, products updates, and other relevant information will be posted to the Announcements Forum. Check the forum regularly to be sure you have the most recent information. You can also sign up to receive The Standard Metric, our weekly newsletter. Circonus Support Team We want all of our customers to be successful with their Circonus deployments. The dedicated support folks at Circonus are ready and willing to help you out. You can submit your question to our support team here: Submit a Ticket Circonus Community When you have a more general question and you are looking for input from a wider audience, the Ask a Question Forum is a great place to start. Perhaps you are looking for input from other Circonus users about how they tackled a specific task, or you want commentary on an idea you have - this is the forum to post in. Circonus Support monitors this forum so its certainly ok (and even encouraged) to ask your technical questions here as well. You can also join the dialog with Circonus engineers and other Circonus users on the Circonus Labs Community Slack Channel. Report a Problem Use the Report a Problem Forum when you think you've spotted a bug. We'll look into it as soon as possible. Suggest a New Feature We get great ideas from our users all the time and many of these ideas are implemented. Submit your killer feature request in the Feature Requests Forum and while you're there, be sure to check out all the other great requests and vote on the ones you like most. <div dir="ltr"><div dir="ltr"><div dir="ltr"><div> <div style="text-align: center;"> <a href="6000040895-api"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" alt="" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a><a href="6000040818-introduction"><p style="display: inline !important;"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541352/original/blob1467412155462.png?1467412155" class="inline-image fr-dii fr-draggable" data-id="6026541352"></p></a> </div> <p style="text-align: center;"><br></p> <p><span>This concludes the New User Walkthrough. We hope you have found it useful and encourage your comments and suggestions.</span></p> <p><span><br></span></p> <p>If you need additional help as you continue to deploy Circonus, there are several additional resources you can use.</p> <p><span><br></span></p> <p><span><strong>Announcements</strong></span></p> <p>Late breaking news, products updates, and other relevant information will be posted to the <a href="/support/discussions/forums/6000178844" target="_blank">Announcements Forum</a>. Check the forum regularly to be sure you have the most recent information.</p> <p><br></p> <p>You can also sign up to receive <a href="http://bit.ly/28NsMyV" target="">The Standard Metric</a>, our weekly newsletter.</p> <p><span><strong><br></strong></span></p> <p><span><strong>Circonus Support Team</strong></span></p> <p><span>We want all of our customers to be successful with their Circonus deployments. The dedicated support folks at Circonus are ready and willing to help you out. You can s</span>ubmit your question to our support team here: <a href="/support/tickets/new" style="background-color: rgb(255, 255, 255);" target="_blank">Submit a Ticket</a></p> <p><br></p> <p><strong>Circonus Community</strong></p> <p>When you have a more general question and you are looking for input from a wider audience, the <a href="/support/discussions/forums/6000178846" target="_blank">Ask a Question Forum</a> is a great place to start. Perhaps you are looking for input from other Circonus users about how they tackled a specific task, or you want commentary on an idea you have - this is the forum to post in. Circonus Support monitors this forum so its certainly ok (and even encouraged) to ask your technical questions here as well.</p> <p><br></p> <p>You can also join the dialog with Circonus engineers and other Circonus users on the <a href="http://slack.s.circonus.com/" target="">Circonus Labs Community Slack Channel</a>.</p> <p><br></p> <p><strong>Report a Problem</strong></p> <p><span>Use the </span><a href="/support/discussions/forums/6000178847" target="_blank">Report a Problem Forum</a><span> when you think you've spotted a bug. We'll look into it as soon as possible.</span></p> <p><span><br></span></p> <p><strong>Suggest a New Feature</strong></p> <p><span>We get great ideas from our users all the time and many of these ideas are implemented. Submit your killer feature request in the </span><a href="/support/discussions/forums/6000178845" target="_blank">Feature Requests Forum</a><span> and while you're there, be sure to check out all the other great requests and vote on the ones you like most.</span></p> <p><span><br></span></p> <p style="text-align: center;"><a href="6000040895-api"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541175/original/blob1467411761240.png?1467411761" data-id="6026541175" style="text-align: center;" alt="" class="fr-dii fr-draggable"></a> <a href="6000040818-introduction" style="text-align: center; background-color: rgb(255, 255, 255);"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541174/original/blob1467411755211.png?1467411755" data-id="6026541174" alt="" style="font-size: 13px;" class="fr-dii fr-draggable"></a><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/6026541352/original/blob1467412155462.png?1467412155" data-id="6026541352" class="fr-dii fr-draggable"></p> <p><span><br></span></p> </div></div></div></div> 6000158965 91 6000040924 2017-09-20T14:48:56-04:00 6003235491 12 2 0 1 Additional Resources 2015-09-21T08:47:22-04:00 6002695175