> For the complete documentation index, see [llms.txt](https://docs.infraon.io/log-management/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infraon.io/log-management/user-guide/infraon-configuration/log-management/log-agent-configuration.md).

# Log Agent Configuration

Log Agent Configuration is used to configure how log agents collect and forward log data from devices or servers to the Infraon Log Management system.

A log agent typically runs on a device or server and collects logs from configured sources. It then forwards these logs to the log management system, where it can process, parse, store, search, and analyze them.

## **How does it work?**

Log Agent Configuration allows administrators to configure how log agents collect and forward log data from devices or servers to Infraon Log Management. The agents send the collected logs to the configured pipeline, where the logs are processed and routed to the appropriate stream for storage, search, and analysis. This enables centralized log monitoring across multiple devices and servers.

* Log collection: Collects log data from configured sources.
* Log forwarding: Sends collected logs to the log management system.
* Centralized monitoring: Makes logs from multiple devices available in one place.
* Troubleshooting and analysis: Helps administrators investigate errors, events, and system activity.

**Log Agent Configuration vs. Pipeline Configuration**

<table data-header-hidden><thead><tr><th width="250.66668701171875" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>Configuration</strong></td><td valign="top"><strong>Purpose</strong></td></tr><tr><td valign="top"><strong>Log Agent Configuration</strong></td><td valign="top">Defines how the log agent collects and forwards log data. The exact settings depend on the available options in the product.</td></tr><tr><td valign="top"><strong>Pipeline Configuration</strong></td><td valign="top">Defines how incoming logs are received, processed, and routed to the appropriate output or stream.</td></tr></tbody></table>

## &#x20;**What you see on the screen**

The Log Agent Configuration page displays the configured log agents and their associated details. Administrators can view agent information, edit or delete individual agents, and select multiple agents for bulk deletion.

Log Agent Configuration | **Basic Details**

<table data-header-hidden><thead><tr><th width="145.3333740234375" valign="top"></th><th width="181" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>Label</strong></td><td valign="top"><strong>Actions</strong></td><td valign="top"><strong>Description/Example</strong></td></tr><tr><td valign="top">Name</td><td valign="top">View</td><td valign="top">Displays the name of the configured log agent, such as Default Windows Agent or Default Linux Agent.</td></tr><tr><td valign="top">Agent Type</td><td valign="top">View</td><td valign="top">Displays the type of log agent, such as Windows Log Agent or Linux Log Agent.</td></tr><tr><td valign="top">Host Name</td><td valign="top">View</td><td valign="top">Displays the hostname of the device associated with the agent.</td></tr><tr><td valign="top">Inventory Agent Linked</td><td valign="top">View</td><td valign="top">Displays the number of inventory agents linked to the log agent, such as 1.</td></tr><tr><td valign="top">Log Collectors</td><td valign="top">View</td><td valign="top">Displays the IP address and port of the associated log collector, such as 10.0.4.132:5048.</td></tr><tr><td valign="top">Action</td><td valign="top">Edit or Delete the agent</td><td valign="top">Provides options to edit or delete an individual log agent.</td></tr><tr><td valign="top">Bulk Delete</td><td valign="top">Select one or multiple agents for bulk delete</td><td valign="top">Allows you to select multiple log agents for bulk deletion.</td></tr></tbody></table>

<figure><img src="https://2594651049-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCD6mgHZ0Xkc8n57NnmFg%2Fuploads%2F2r8UWCwutJNzCZQjG4Vv%2Fimage.png?alt=media&amp;token=b745749e-5df5-4cbe-a7be-a33cac02c6ce" alt=""><figcaption></figcaption></figure>

### **Agent Action Profiles**

The Agent Action Profiles section displays the history and results of actions performed on log agent profiles, such as Check Configurations and Install in the Inventory Agent page. It allows administrators to review agent validation results and identify devices with issues.

Log Agent Configuration | **Agent Action Profiles**

<table data-header-hidden><thead><tr><th width="174.5" valign="top"></th><th width="258.5" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>Label</strong></td><td valign="top"><strong>Action</strong></td><td valign="top"><strong>Description/Example</strong></td></tr><tr><td valign="top">Agent Action Profiles</td><td valign="top">Open Log Agent Configuration and view the agent action profiles.</td><td valign="top">Displays the history of actions performed on log agent profiles and their results.</td></tr><tr><td valign="top">Created At</td><td valign="top">View the table entry.</td><td valign="top">Displays the date and time when the action was initiated.</td></tr><tr><td valign="top">Total Agents Triggered</td><td valign="top">View the table entry.</td><td valign="top">Displays the total number of agents for which the action was triggered.</td></tr><tr><td valign="top">Valid Agents</td><td valign="top">View the table entry.</td><td valign="top">Displays the number of agents that passed validation.</td></tr><tr><td valign="top">Invalid Agents</td><td valign="top">View the table entry.</td><td valign="top">Displays the number of agents that failed validation.</td></tr><tr><td valign="top">Status</td><td valign="top">View the table entry.</td><td valign="top">Displays the overall result of the action, such as Invalid.</td></tr><tr><td valign="top">Created By</td><td valign="top">View the table entry.</td><td valign="top">Displays the name of the user who initiated the action.</td></tr><tr><td valign="top">Log Agent Configurations</td><td valign="top">Click Log Agent Configurations.</td><td valign="top">Opens the log agent configurations view.</td></tr><tr><td valign="top">Info</td><td valign="top">Click the information icon in the Action column.</td><td valign="top">Opens the Agent Actions Profiles Device Status view, which displays device-level results for the selected action.</td></tr><tr><td valign="top">Action</td><td valign="top">View the table entry.</td><td valign="top">Displays the action performed, such as Check Configurations or Install.</td></tr></tbody></table>

<figure><img src="https://2594651049-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCD6mgHZ0Xkc8n57NnmFg%2Fuploads%2FjNjR03tE3miNp7TpjEro%2Fimage.png?alt=media&amp;token=58e6d994-d954-43c0-b8f5-71824719c499" alt=""><figcaption></figcaption></figure>

Agent Action Profile | **Actions**

<table data-header-hidden><thead><tr><th width="144.50006103515625" valign="top"></th><th width="137.6666259765625" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>Label</strong></td><td valign="top"><strong>Action</strong></td><td valign="top"><strong>Description/Example</strong></td></tr><tr><td valign="top">Agent Actions Profiles</td><td valign="top">Click</td><td valign="top">When you click the Info icon, the device status view displays the results for individual devices, including their hostnames, IP addresses, operating systems, status, and messages.</td></tr><tr><td valign="top">All</td><td valign="top">Click All.</td><td valign="top">Displays all devices included in the selected agent action.</td></tr><tr><td valign="top">Invalid</td><td valign="top">Click Invalid.</td><td valign="top">Displays devices marked as invalid.</td></tr><tr><td valign="top">Pending</td><td valign="top">Click Pending.</td><td valign="top">Displays devices with a pending status.</td></tr><tr><td valign="top">Success</td><td valign="top">Click Success.</td><td valign="top">Displays devices for which the action completed successfully.</td></tr><tr><td valign="top">Failed</td><td valign="top">Click Failed.</td><td valign="top">Displays devices for which the action failed.</td></tr><tr><td valign="top">Configuration Wrong</td><td valign="top">Click Configuration Wrong.</td><td valign="top">Displays devices with configuration issues.</td></tr><tr><td valign="top">Search</td><td valign="top">Enter a search term.</td><td valign="top">Searches the device status records.</td></tr><tr><td valign="top">Host Name</td><td valign="top">View the device record.</td><td valign="top">Displays the device hostname, such as 336-Dhusnic-DM-EIMS.</td></tr><tr><td valign="top">IP Address</td><td valign="top">View the device record.</td><td valign="top">Displays the IP address or addresses associated with the device.</td></tr><tr><td valign="top">OS Name</td><td valign="top">View the device record.</td><td valign="top">Displays the operating system, such as Microsoft Windows 11 Pro.</td></tr><tr><td valign="top">Status</td><td valign="top">View the device record.</td><td valign="top">Displays the result for the device, such as Invalid.</td></tr><tr><td valign="top">Message</td><td valign="top">View the device record.</td><td valign="top">Displays details about the device status, such as Agent is not reachable or Log agent is in Running state.</td></tr><tr><td valign="top">Close</td><td valign="top">Click X.</td><td valign="top">Closes the device status view.</td></tr></tbody></table>

<figure><img src="https://2594651049-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCD6mgHZ0Xkc8n57NnmFg%2Fuploads%2FZ771x626tSI2ZaKTfPqv%2Fimage.png?alt=media&amp;token=b459644a-c468-435d-a51e-62cfbaed5c2c" alt=""><figcaption></figcaption></figure>

## **Add Log Agent Profile**

The Add Log Agent page allows administrators to create a log agent configuration by specifying agent details, selecting inventory agents, configuring log sources, and defining log collector hosts.

Add Log Agent | **Log Agent Details**

<table data-header-hidden><thead><tr><th width="149.5" valign="top"></th><th width="175.666748046875" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>Label</strong></td><td valign="top"><strong>Action</strong></td><td valign="top"><strong>Description/Example</strong></td></tr><tr><td valign="top">Agent Name *</td><td valign="top">Enter a name.</td><td valign="top">Specifies the name of the log agent configuration.</td></tr><tr><td valign="top">Agent Type *</td><td valign="top">Select an agent type.</td><td valign="top"><p>Specifies the type of log agent.</p><p></p><p><strong>Example</strong>: Windows Log Agent.</p></td></tr><tr><td valign="top">Inventory Agents *</td><td valign="top">Select an inventory agent.</td><td valign="top">Associates the configuration with the selected inventory agent.</td></tr><tr><td valign="top">Log Agent Configurations</td><td valign="top">Configure</td><td valign="top">This section allows you to configure log sources and define filtering or collection settings for each source.</td></tr><tr><td valign="top">Windows Configuration</td><td valign="top">Configure the available log sources.</td><td valign="top">Displays the configuration options for the selected Windows Log Agent.</td></tr><tr><td valign="top">Log Source</td><td valign="top">Select a source from the dropdown.</td><td valign="top"><p>Specifies the log source to configure.</p><p>Examples: Application, System, Security, Windows PowerShell, and ForwardedEvents.</p></td></tr><tr><td valign="top">Configuration Value</td><td valign="top">Enter the required configuration.</td><td valign="top"><p>Specifies additional settings for the selected source.</p><p>Examples: ignore_older: 72h, event_id: 400, 403, 600, 800, and tags: [forwarded].</p></td></tr><tr><td valign="top">Delete</td><td valign="top">Click the delete icon beside a configuration row.</td><td valign="top">Removes the corresponding log source configuration.</td></tr><tr><td valign="top">Add Configuration</td><td valign="top">Click Add Configuration.</td><td valign="top">Adds another row to configure an additional log source.</td></tr><tr><td valign="top">Input</td><td valign="top">Configure</td><td valign="top"><p>This section allows you to specify the log collector host information for the agent configuration.</p><p> </p></td></tr><tr><td valign="top">Log Collectors</td><td valign="top">Enter the log collector address.</td><td valign="top">Specifies the log collector host or endpoint associated with the configuration.</td></tr><tr><td valign="top">Delete</td><td valign="top">Click the delete icon beside the host field.</td><td valign="top">Removes the corresponding log collector entry.</td></tr><tr><td valign="top">Add Host</td><td valign="top">Click Add Host.</td><td valign="top">Adds another host entry for a log collector.</td></tr></tbody></table>

<figure><img src="https://2594651049-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCD6mgHZ0Xkc8n57NnmFg%2Fuploads%2FdOV9Sy4KJmXjmp5ll34b%2Fimage.png?alt=media&amp;token=8c87ab31-b296-4a41-ac08-61e056f8ae08" alt=""><figcaption></figcaption></figure>

After configuring the required details for the log agent, click Save to save the configured log agent.
