This tutorial will help you navigate through the main capabilities in Coralogix’s new logs screen.
Moving between screen styles
Currently both Logs screens are available and you can move between them by using the ‘Logs’ menu.
The tutorial is organized by functionality:
- Queries and filters
- Rapid visualizations
- Custom views
Moving between screen styles
Queries and Filters
Queries are a combination of time selection, search query, and filter selections.
To make a time selection click on the time selection box on the upper right corner of the browser window
This will open few options for time selections:
- Quick – Select a predefined query interval with one click
- Relative – Choose a time window between (current time – t1) and (current time – t2)
- Custom – Choose between two absolute dates and times
- Tags – Choose an application tag.
Dragging the mouse across a section of the logs flow graph will zoom into the previous query time range and set a new time interval.
During root cause and impact analysis it is often the case that users would like to define a query window around a specific event represented by a log. In order to do so, move the mouse to the left of the log’s timestamp. Click the 3 dots that appear on the screen and choose the time window you want the query to run, around this specific log.
Search queries are still conducted mainly from the “Search logs” entry field. You can read about queries here. The new logs screen includes facilities that help you build queries based on the log fields. When clicking on a json field value a drop down menu opens.
Clicking on the option “INCLUDE IN QUERY” will add the expression ‘_exists_: “IP_geoip.ip”‘ to the query. Choosing the exclude option will add the expression ‘NOT _exists_: “IP_geoip”‘ to the query. You can also copy the complete json path to the clipboard, which can help in building query expressions.
The filters section occupies the left side of the Logs tab. It enables the selection of specific values to be queries per filter. By default the screen opens with application, subsystem, and severity filters, but the filters are completely customizable and metadata or log field are available.
Filters can be minimized and deleted using the ^ and x icons to the right of the filter name. The graph icon allows for rapid visualization of the filter values (see next section).
Filters can be added by clicking the “ADD FILTER” button at the top of the filter section. They can also be added by choosing the “ADD TO FILTER LIST” option in the dropdown menu that opens when clicking on a json field.
Clearing a query
Clicking on the x to the right of the query string will delete the query string but will not affect the rest of the query parameters (filters and time window).
Clicking on the “RESET” button will clear all query parameters (including filters).
When performing root cause and impact analysis it is very common to look at values distribution, the distribution of ip addresses, user names, sub systems etc. Within a set of logs, this can give us clues about offending components, where is the problem is, and what is its impact. Coralogix users can generate very sophisticated visualizations and dashboards using Kibana, Grafana and other tools. The logs screen provides ways to rapidly generate count-based visualizations as part of the analyst log flow. These visualizations can be pinned to your main dashboard and to the tags tab.
Choose the logarithmic option if there is order of magnitude variation in the distribution.
The filters section on the left shows the count-per-filter value. It will also provide a way to generate a count distribution graph for the filtered key. Hover with mouse above the specific filter area. Click on the graph icon to right of the filter name, and a graph similar to the above will be generated.
A third option of creating a rapid visualization can be found in the settings menu. The visualization will track the count of logs (same as the log flow graph at the top of the screen) per time window selected and the query parameters that are currently effective in the logs screen.
Custom views help users look at the specific log information that is important for them, as well as create views that will help other users be more efficient, even if they are less technical or don’t know the logs as well.
A view is defined by a query (see the “Queries and filters” section) that creates the initial logs set that the view starts with, and columns (each column corresponds with a log field) that define the log data the user will see. ‘Text” is a special column (or field) that holds the entire log (excluding metadata). Every field can be removed or added to a view.
Adding a column can be done by clicking on a json field and choosing the “ADD AS COLUMN” option from the dropdown menu.
It can also be added from the ‘COLUMNS” button.
Clicking on “COLUMNS” button will open the “Manage columns” window. You can move fields between the two lists by dragging them. Press the “APPLY” button to make sure the action takes effect. The “Manage columns” window can also be accessed from the “SETTINGS” menu.
A view can be saved by using the “SAVE VIEW” option.
Clinking on it will open a window where you enter the name for the custom view, and indicate if it includes the query selection, if it is the new default view, and if it private or available to all the account users.
To open a saved view, click on save view or the arrow near the view name and scroll down to the list of saved views (“MY VIEWS” and “SHARED VIEWS”).
Our customers are one of our main sources of innovation, we’d love to hear from you! Please send us your feedback to firstname.lastname@example.org or via the chat box in the lower right corner of the screen.