Logs are essential for tracking the activity of a component. This will help to understand the current behaviours or history of the OpenEBS component. Director Online has a centralized logging system where users cluster data is stored in Director Online central Elasticsearch cluster. Centralized Log Management (CLM) is a type of logging solution system that consolidates all of your log data and pushes it to one central, accessible, and easy-to-use interface. Director Online stores the logs of the last 7 days by default. Retention period can be upgraded based on the plans in Director Online. Click here to know more. Director Online collects the logs of the following components:
- maya-system namespace components.
- openebs namespace components.
- Kubelet.
- OpenEBS volume pod.
Setting the Time filter
DirectorOnline shows the last 15 minutes logs by default. The time period of logs being viewed can be changed by clicking on the time filter present on the top right of the page. You can select a specific time interval or time range.
- Setting the Refresh Interval: In order to set the refresh interval Click on the button(encircled in the image below) and select the interval
[Note: you can switch off the refresh interval as well]
- Setting the Time Range: You can set your time range by clicking on the button as shown in the image.
Accessing Logs
- Search: You can submit search queries, filter the search results, and view logs. You can also see the number of logs that matches the search query(mentioned as hits just above the search box).
To search your logs,- Enter your search criteria in the Query bar.
- Press Enter or click Search to submit the request.
- Saving Searches: You can save the search results to reload and use them later, without submitting a query again.
- To save a search:
- First, apply the search query as shown above.
- Click on the Save button in the toolbar.
- Enter the search name and click Save.
- Opening a search:
To load a saved search,- Click on the Open button in the toolbar.
- Select the search from the list of searches to open.
Filtering by components/elements
Logs specific to a component (like host, pod, etc) can be viewed by applying Filters.
There are two ways to add a Filter:
-
- Click on the Add a filter + button.
- Select a filter you want to apply, example kubernetes.pod_name.keyword (using keyword will list all the components available).
- Select the component from the list.
- Click Save.
- Left panel shows all the filters applicable in that time interval (filters are actually the fields in the document) such as “kubernetes.pod_name”, “kubernetes.host”, “kubernetes.labels.openebs_io/persistent-volume” etc.
- Clicking on any of the filters will list the top 5 components based on the documents/values.
- You can directly add that filter by clicking on the positive filter button () next to the component.
