Fortinet Document Library

Version:


Table of Contents

User Guide

21.4.0
Copy Link

Linux Log Monitoring

The Linux log monitoring agent plugin allows you to monitor for occurrences of a defined pattern over a given period of time in a specific log file. A simple example would be to monitor the number of times the string "ERROR" appeared in your Apache logs over the past 5 minutes.

Metric Configuration

As a prerequisite, ensure you have the latest version of the Linux agent installed - if you need a refresher, go here.

Within the Linux monitoring category in the monitoring configuration table, click Add Metric. The Linux metric configuration drawer should now be open on the right side of the page.

Navigate to the Logs section.

Metric

Unit

Events

count

Select Add to add and configure the Events metric.

Field

Description

Log Location

The full path to the log file which you would like to monitor.

Log Message Regex Filter

A regex to utilize on each logline. This should be used to look for the specific occurrence you are concerned with. If left blank, this will count every line in the file.

Time Frame

How far back to look for occurrences. For instance, if you want to check for "errors in the past 5 minutes", select 5 minutes.

Frequency

How often the metric should be collected.

Tags

Add tags to the metric.

Because of how the results buffer is built, it will take a period of time to build the initial metric value. This period is the same length of time as the configured Time Frame.

If you have any additional questions, please contact our support team.

Linux Log Monitoring

The Linux log monitoring agent plugin allows you to monitor for occurrences of a defined pattern over a given period of time in a specific log file. A simple example would be to monitor the number of times the string "ERROR" appeared in your Apache logs over the past 5 minutes.

Metric Configuration

As a prerequisite, ensure you have the latest version of the Linux agent installed - if you need a refresher, go here.

Within the Linux monitoring category in the monitoring configuration table, click Add Metric. The Linux metric configuration drawer should now be open on the right side of the page.

Navigate to the Logs section.

Metric

Unit

Events

count

Select Add to add and configure the Events metric.

Field

Description

Log Location

The full path to the log file which you would like to monitor.

Log Message Regex Filter

A regex to utilize on each logline. This should be used to look for the specific occurrence you are concerned with. If left blank, this will count every line in the file.

Time Frame

How far back to look for occurrences. For instance, if you want to check for "errors in the past 5 minutes", select 5 minutes.

Frequency

How often the metric should be collected.

Tags

Add tags to the metric.

Because of how the results buffer is built, it will take a period of time to build the initial metric value. This period is the same length of time as the configured Time Frame.

If you have any additional questions, please contact our support team.