Metrics Exploration

.

Search for Metrics

BeeInstant’s advanced metrics explorer makes it effortless to find the metrics you are looking for. Searching for metrics is done on the app.beeinstant.com/graph page and is case insensitive. Whenever a metric is searched, the search table below will display up to 99 results. If you cannot see the metric you are looking for in the 99 you may need to refine your search further. The results are returned in multiple tables with the appropriate dimensions. The results are not returned in one fixed table because you are able to define your own dimensions, the metric storage is schemaless.

Metrics Explorer

A specific search is a search that returns a metric that exactly contains the searched word, if the letters of a metric are in a different order, there is one letter missing or one additional letter then the metric will not be returned. A specific search can be done by using the following format.

dimension=$term$

Dimension will be the heading of the column you are searching for, for example Class, Service or Type. Term will be the specific metric you are searching for.

To do a broad based search you omit the dollar signs. This returns any metrics that are wholly or partly made up of the searched query. for example,

env=prod
env=$prod1$

The top line returns results where the “env” dimension contains the word prod. The bottom line returns results where the “env” dimensions is “prod1”, it will not return “prod” or “prod12”

Search Operators

Search Operator Description
AND / & This operator is used when searching by multiple dimensions. For example, the search query "CPU AND usage AND cpu_4" will return any CPU usage related metrics from cpu_4 while omitting all other CPU metric types and other CPU's

note: AND is inherently present in any metrics that have a space between them. For example, the phrase "CPU usage" behind the scenes is parsed as "CPU AND usage" so most of the time you can omit the AND.

OR / | This operator is used when you want to return metrics that are part of A, Or B, OR Both. For example, to return all metrics from cpu1 and cpu2 we would search "cpu1 or cpu2"
NOT / ! This operator is used when you want to exclude a particular metric from the search results. For example, searching "CPU" would return all our CPU related metrics, however, if we search "CPU NOT CPU2" it will return every CPU except for CPU 2.

note: When using this operator ensure that if using "NOT" there is a space before and after the word, for example, "CPU NOTCPU2" returns metrics that contain CPU and NOTCPU2 which is not what we want. If using the "!" however ensure there is no space after the word. This means our previous command would be "CPU !CPU2"

* This operator matches zero or more characters. For example, by searching "Bee*", BeeInstant will be returned and any other metrics that begin with bee
? This operator matches exactly one character. For example, given 10 servers labelled server0...server9, the search query "server?" will return all server dimensions.

Creating Alarm Details

BeeInstant has developed an intuitive point and click search to make it easier for you to quickly search and refine metrics. This feature can be seen by hovering over any data cell in the search results table.

Creating Alarm Details

Exact Search:It eliminates any search query currently in the search box and performs a specific search on the clicked metric. For example if exact search was clicked on th above picture it would search “Location=$Dublin$”

Add Search: This adds a specific search of the clicked metric to the current search query, further refining the search results.

Remove Search: There is two possible results when this is clicked. If the clicked metric is present in the search box it will remove it. If the clicked metric is not present in the search box then it will exclude it from the search results by appending NOT followed by the metric to the search box.

Plot Metrics

Each individual metric will have its own plot button in it’s row, pressing this will draw the metric on the graph. You can plot as many metrics as you wish on the graph. By hovering over the eye to the right of the search bar you can also plot groups of metrics at once.

Metrics Explorer

With one click you can plot the top 10 metrics, bottom 10 metrics or sort the metrics ascendingly or descendingly. It is also possible to plot any of these four groups by the average of/sum of the Number of Observations, average, minimum, maximum, sum, P99.99. P99.9, P99, P99, P90, P80, P70, P60 or P50. Furthermore you can group your metrics by dimension and plot them to easily compare groups against each other

Metrics Explorer

Graph Type

BeeInstant also supports displaying graphs as line charts, bar charts and pie charts. Changing graph type is simple, just hover over the menu at the type right of the graph and you will be provided with the option of changing graph type and aggregation type e.g Min, Max, Sum, Count, average, first point or last point.

Note that while a line graph can display data over a period of time, a bar and pie chart can only display data for one moment in time. Therefore while linegraph needs only one analysis type, average/min for example, pie and bar chart needs two. So if the line chart is displaying the maximum data point for each time period and we plot bar chart and select minimum. It will display the analyse the maximum for each time period and display the minimum point.

Metrics Explorer

Metrics Analysis

Once a metric is plotted an options area will appear to the right hand side of the graph. This section enables you to edit metrics, change aggregation type, use our anomaly detection tool, add markings and much more.

Metrics Explorer

At the top you will see 4 buttons side by side.

Button Description
Snapshot This takes a snapshot of the graph as you are looking at it and provides a download link to download th image as a PNG.
Save This saves an image to the clipboard, if you accessed the graph through the dashboard or alarms page it will save this graph to the section you clicked from.
Share This provides a shortened sharable link that you can share with others, upon opening a user will see exactly what you see, including any edits you made to the metric prior to generating the link
Clear This clears all graphs on the page leaving just the search box and results

Timescale

The enables you to change how far back the data should go. By clicking one of the predefined values, 1h, 1day, 1week, 1month for example it goes back that timeperiod from now. However, if you wanted to select a custom time range you can click on the calender icon which will enable you to select day, hour and minute for to and from time trange.

Metrics Explorer

Markings

These three boxes allow you to draw lines on the graph. Left is for the left y-axis, right is for the right y-axis. By default all metrics are plotted on the left-axis, by hovering over the metric panel you will be presented with an option to plot the metric on the y-axis. In order for y-axis marking to work correctly there must be at least one metric plotted on it.

The last box is for time. The format is milliseconds since the epoch. It draws a vertical line on the graph marking the timestamp.

Metric Panel

On the left-hand side of the metric panel is the metric title, by clicking on the title the box can be minimized. To change the label simply edit the text-field label just underneath. To the right wee see the time period we wish datapoints to be displayed as, by default data is presented in a minutue-by-minute fashion, however by extending the time period to 5mins or even 1hour it can be easier to see trends. To the right of the time period is the aggregation type, by default it is set to average, however, you can change it to min, max, count, sum or any of the percentiles.

By hovering over the metric panel a bar should pop up at the top, this enables you to plot the metric on the left or right axis, delete the specific metric aswell as being able to access further analysis functions. The analysis function menu provides 4 menu items.

Metrics Explorer

Button Description
Duplicate This duplicated the metric, creating a new panel and changing the label to {metric-name} duplciated. Perfect if you want to save your metric while you make some edits on it.
Shift This provides you with the ability to shift the metric back 1 hour, 1 day or 1 week. While these are the only predefined timeperiods you can edit the timeperiod in the f(x) box if you wish to shift by a custom time period, e.g 3 days. When this is clicked it duplicates the metric and shift one of them back by the given time period, the label of the shifted metric will change indicating the length back it has been shifted.
Search This performs a specific search on every dimension of the metric and searches it in the search box. This is perfect for if your looking to find similar metrics to the one you are currently looking at.
Custom Function This enables/disables the custom function. Enabling it allows you to perform metric math aswell as shitfting values and perform audit. Disabling it disables all the functions applied to the specific metric but does not remove them, upon clicking function again the functions will return.

Metric Math

Functions should be seperated by a semi-colon to indicate when a new function starts. You can shift a graph back in time using shift(-{amount}{period}). For example shift(-3d) shifts back 3 days while shift(-4w) shifts back 4 weeks. By typing audit in the custom function BeeInstant’s intelligent anomaly detection tool will run on the metric, if an issue is found it will be highlighted in the graph, if no issue is found them metric will disappear from the graph. Removing the audit keyword or disabling custom function will make the metric come back. Elementary Mathematics can also be performed such as squaring the values (x * x) raising the value to a power of another number (x ^ 4) or even just converting bytes to kilobytes x / 1024

Build Dashboards

When you first begin sending metrics to BeeInstant a default dashboard is created for you containing many crucial infrastructure metrics. As you add custom metrics you may want to begin making additional dashboards to make analysisng your data more efficient

                                            Image of dashboardino

Creating and Editing Dashboards

At the top left is the label indicating what dashboard you are currently looking at and beside that is a side menu which when expanded enables you to create or edit an existing dashboard. Upon opening there is only 3 sections which need filling in:
Dashboard Name: Name given to identify the dashboard
Order: The order the dashboard will appear in the list, the lower the number the higher in the list it will appear
Dashboard Description: Brief description explaining what graphs can be found in the dashboard

Each dashboard also has its own quick links sections which can be found to the left of the dashboard name. You can add any external links here which people may need for more information. At the top of the dashboard is also a time range that effects all the graphs on the given dashboard. You can select a predefined time or use a custom time range by clicking on the calender icon

Dashboard Structure

A dashboard is comprised of sections, which in turn is comprised of rows of 1,2 or 3 columns. To make a new section navigate to the bottom left of the page and select add section, here select whether you want 1,2 or 3 columns (this can be easily changed later). Once the section is made it will be given a default name of Section {ID}. To change this navigate to the right of the section header where you will see a dropdown menu prompting you to edit or delete. Clicking edit will prompt you to enter order and a dashboard name.

Customising Sections

The right most menu on each row is the dropdown which controls that row, while all other dropdowns control the graph which the are displayed inside. Clicking on the rightmost arrow in a row with one or 2 graphs will present you with the option to expand the row, adding another blank graph to the right. Clicking the right most arrow with any number of graphs in it will allow you to delete the row. Pressing delete on any of the graph dropwdown menus will enable you to delete the column. Furthermore, if the row is on any row but the first it will present you with the option to move it up one row. To add another row to a section click the bottom most add Graph button and select how many columns you want

Adding and Editing Graphs

Any blank space will be populated by an add graph button, click which will bring you to the metrics explorer. Search for the metric you wish to add to the dasboard, plot it, make any change if any and then click the save button. The metric should now be saved to the dashboard. Alternatively you can do it the other way by clicking save in the metrics explorer, navigating to the section of the dashboard you want to save the graph to, click the dropwdown menu and click paste to insert the graph. The graphdropdown also has other features such as the ability to add a description to the graph, to clear the graph from the column, to copy the graph to paste elsewhere or to cut the graph to remove it from its previous position upon pasteing.