In my previous blog , I described how to configure log sources to forward logs to vRealize Log Insight Cloud. Once the logs are in the next step is to start leveraging one of the most powerful features of vRealize Log Insight Cloud i.e., Content Pack.
In this blog I will walk through
- What is a content pack?
- Benefits of content pack
- Types of content pack
- How to use OOTB content pack
- How to create content and export a custom content pack
- How to import a custom content pack
What is content pack?
It is a collection of following objects that are relevant for set of product/application logs
- Alerts
- Dashboards
- Queries
- Extracted fields
Benefits of content pack
It provides following benefits
Types of content pack
There are 2 types of Content Packs
Public
These are OOTB content packs included in vRealize Log Insight Cloud service. While writing this blog we have total 122 public content packs
Private
These are custom content packs which any user can import into vRealize Log Insight Cloud. For e.g. I have published a simple one for Openshift logs on VMware Code platform which can be downloaded and imported https://developer.vmware.com/samples/7217/openshift_logs_v1.0.lint
How to use OOTB content pack
The first step is to enable the OOTB content pack.
Enable the content pack
Expand the main menu and click Content Packs. On the Public tab, click the toggle next to the title of the content pack to activate or deactivate it. The toggle is green when it is activated and gray when it is deactivated.
In our example we will be enabling “AWS – Cloud services” content pack. This content pack provides event logs for many popular AWS services such as S3, SNS, SQS, Kibana, DynamDB, RDS etc.
Visualize the Dashboard
Once it is enabled successfully you will be able to see Alerts/Dashboards/Queries however the alerts from the content pack are not enabled by default. You can enable the alerts in the Alert Definitions page
Now you can visualize the data in the dashboards for e.g. Following is the S3 Overview Dashboard. Following are some of the widgets of the dashboard
- Total number of AWS Cloud trail S3 API calls
- AWS S3 API calls over time range
- AWS S3 events over all users
- Public IP addresses accessed over time
- AWS S3 events by buckets
If you can analyze the logs in depth, you can view the actual log message by clicking on three dots and selecting View Log Query
This will open the Explorer Logs page which will show the actual logs
How to create content and export a custom content pack
Users can create private (user-defined) content such as Queries, Dashboards, Alerts and export them as a JSON file. This can be shared with other users. For e.g. I have published a simple content pack for OpenShift logs on VMware Code platform which can be downloaded and imported https://developer.vmware.com/samples/7217/openshift_logs_v1.0.lint
Create content
Save a query
Expand the main menu and click Explore Logs. Enter a query and click the Search button to view the results. In the upper-right corner of the page, click the Save icon. In the pop-up window, enter a name and description for the query and click Save.
Create Dashboard
Expand the main menu and click Explore Logs. Enter a query and click the Search button to view the results. In the upper-right corner of the page, click the three dots icon and select Add to Dashboard. In the Add Widget to Dashboard pop-up window, enter the name, type, and description for the widget to add to the dashboard. Under the widget details, click New Dashboard. Enter a name for the dashboard and click Add
Export custom content pack
Expand the main menu and click Content Packs. In the upper-right corner of the page, click Export Content. In the left section of the pop-up window, enter metadata for the content pack (Name, Namespace, Version). In the right section of the pop-up window, select the user-defined elements that you want to include in the content pack. Click Export and save the file to a location on your computer.
The exported file with extension. lint is stored in the specified location. The details in this file are JSON formatted
How to import a custom content pack
If someone has shared you the JSON file which includes the custom(user-defined) content, you can import them into vRealize Log Insight Cloud and start using the same.
Expand the main menu and click Content Packs. On the Private tab, click Import Content. In the pop-up window, select the import method. Select File. Browse for a content pack JSON file and click Open. Click Import
If the content is imported as a content pack, then it will appear under the Private tab.
Next Steps
If you’re not already using vRealize Log Insight Cloud, check out our free 30 day trial. To learn more about how to use vRealize Log Insight Cloud, please check out
- VMware Pathfinder.
- VMware Cloud Management Blogs
- VMware Cloud Management You Tube Channel