This section describes how to use Log2Metrics in Apica Ascent.
Apica Ascent Log2Metrics is a powerful feature that helps you convert your log data into a real-time metric. Using Log2Metrics, you can visualize your log data, plot distributions, create a custom index, and create alerts for events.
You can create new metrics from a log line in either the Logs page or the Search page of your Apica Ascent UI. To create a new metric, click the three dots on a log line that you want to create a metric for. Doing so opens the options menu, as shown in the following image. From the options menu, click create log2metric.
Log options menu
You will now see the Log2Metric modal on the Apica Ascent UI. To configure your new metric, fill out the fields in the Log2Metric modal appropriately.
The following table describes each of the fields in the Log2Metric modal.
You can add more parameters to filter your logs by clicking on +Add more parameters, as shown in the following image.
Add more prameters
The configuration depicted in the image above creates a Log2Metric named
ingress_status_codes__e1034e. Apica Ascent adds the suffix
__e1034internally as a unique identifier for the Log2Metric. Once the Log2Metric is created, it adds its visualization to your dashboard. The following image depicts the visualization of the newly-created
Visualization created by log2metrics
Log2metrics helps to analyze the log for the specified time series.
Analysebutton will open the popup with values that can be choose to verify the logs as shown below. Choose the values that you want to analyze within the logs and click
Applybutton, it will navigate to the search view and the corresponding logs will be loaded to verify.
Log2Metrics definitions also create custom indices that can be used to speed up the search. Based on the definition, there can be multiple custom indices. The definition used in the example above creates two custom indices:
e1034e. You can use both of these indices to search for logs that match the definition. Based on what you enter in the Labels field of the Log2Metric configuration, additional indices may be created. For example, based on the definition used in the example above, if there are logs that match the status code
401, an additional index is created named
ingress_status_codes__e1034e_status_code_401that can be used for searching for occurrences of logs that contain the status code