You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/azure-monitor/agents/agent-linux.md
+19-20Lines changed: 19 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,8 +27,7 @@ The following sections outline the requirements for installation.
27
27
28
28
For a list of Linux distributions supported by the Log Analytics agent, see [Overview of Azure Monitor agents](agents-overview.md#supported-operating-systems).
29
29
30
-
>[!NOTE]
31
-
>OpenSSL 1.1.0 is only supported on x86_x64 platforms (64-bit). OpenSSL earlier than 1.x isn't supported on any platform.
30
+
OpenSSL 1.1.0 is only supported on x86_x64 platforms (64-bit). OpenSSL earlier than 1.x isn't supported on any platform.
32
31
33
32
>[!NOTE]
34
33
>The Log Analytics Linux agent doesn't run in containers. To monitor containers, use the [Container Monitoring solution](../containers/containers.md) for Docker hosts or [Container insights](../containers/container-insights-overview.md) for Kubernetes.
@@ -52,11 +51,11 @@ Starting from agent version 1.13.27, the Linux agent will support both Python 2
52
51
53
52
If you're using an older version of the agent, you must have the virtual machine use Python 2 by default. If your virtual machine is using a distro that doesn't include Python 2 by default, then you must install it. The following sample commands will install Python 2 on different distros:
54
53
55
-
- Red Hat, CentOS, Oracle: `yum install -y python2`
56
-
- Ubuntu, Debian: `apt-get install -y python2`
57
-
- SUSE: `zypper install -y python2`
54
+
-**Red Hat, CentOS, Oracle**: `yum install -y python2`
55
+
-**Ubuntu, Debian**: `apt-get install -y python2`
56
+
-**SUSE**: `zypper install -y python2`
58
57
59
-
Again, only if you're using an older version of the agent, the python2 executable must be aliased to *python*. Following is one method that you can use to set this alias:
58
+
Again, only if you're using an older version of the agent, the python2 executable must be aliased to *python*. Use the following method to set this alias:
60
59
61
60
1. Run the following command to remove any existing aliases:
62
61
@@ -89,15 +88,15 @@ The following table highlights the packages required for [supported Linux distro
89
88
90
89
|Required package |Description |Minimum version |
91
90
|-----------------|------------|----------------|
92
-
|Glibc | GNU C Library | 2.5-12
93
-
|Openssl | OpenSSL Libraries | 1.0.x or 1.1.x |
91
+
|Glibc | GNU C library | 2.5-12
92
+
|Openssl | OpenSSL libraries | 1.0.x or 1.1.x |
94
93
|Curl | cURL web client | 7.15.5 |
95
94
|Python | | 2.7 or 3.6+
96
95
|Python-ctypes | |
97
-
|PAM | Pluggable Authentication Modules | |
96
+
|PAM | Pluggable authentication modules | |
98
97
99
98
>[!NOTE]
100
-
>Either rsyslog or syslog-ng are required to collect syslog messages. The default syslog daemon on version 5 of Red Hat Enterprise Linux, CentOS, and Oracle Linux version (sysklog) isn't supported for syslog event collection. To collect syslog data from this version of these distributions, the rsyslog daemon should be installed and configured to replace sysklog.
99
+
>Either rsyslog or syslog-ng is required to collect syslog messages. The default syslog daemon on version 5 of Red Hat Enterprise Linux, CentOS, and Oracle Linux version (sysklog) isn't supported for syslog event collection. To collect syslog data from this version of these distributions, the rsyslog daemon should be installed and configured to replace sysklog.
101
100
102
101
### Network requirements
103
102
For the network requirements for the Linux agent, see [Log Analytics agent overview](./log-analytics-agent.md#network-requirements).
@@ -114,9 +113,9 @@ The Log Analytics agent for Linux is composed of multiple packages. The release
114
113
115
114
Package | Version | Description
116
115
----------- | ----------- | --------------
117
-
omsagent | 1.14.19 | The Log Analytics Agent for Linux.
116
+
omsagent | 1.14.19 | The Log Analytics agent for Linux.
118
117
omsconfig | 1.1.1 | Configuration agent for the Log Analytics agent.
119
-
omi | 1.6.9 | Open Management Infrastructure (OMI), a lightweight CIM Server. *Note that OMI requires root access to run a cron job necessary for the functioning of the service*.
118
+
omi | 1.6.9 | Open Management Infrastructure (OMI), a lightweight CIM Server. *OMI requires root access to run a cron job necessary for the functioning of the service*.
120
119
scx | 1.6.9 | OMI CIM providers for operating system performance metrics.
121
120
apache-cimprov | 1.0.1 | Apache HTTP Server performance monitoring provider for OMI. Only installed if Apache HTTP Server is detected.
122
121
mysql-cimprov | 1.0.1 | MySQL Server performance monitoring provider for OMI. Only installed if MySQL/MariaDB server is detected.
@@ -132,17 +131,17 @@ Installing the Log Analytics agent for Linux packages also applies the following
132
131
* A sudoers *include* file is created in `/etc/sudoers.d/omsagent`. This file authorizes `omsagent` to restart the syslog and omsagent daemons. If sudo *include* directives aren't supported in the installed version of sudo, these entries will be written to `/etc/sudoers`.
133
132
* The syslog configuration is modified to forward a subset of events to the agent. For more information, see [Configure Syslog data collection](data-sources-syslog.md).
134
133
135
-
On a monitored Linux computer, the agent is listed as `omsagent`. `omsconfig` is the Log Analytics agent for the Linux configuration agent that looks for new portalside configuration every 5 minutes. The new and updated configuration is applied to the agent configuration files located at `/etc/opt/microsoft/omsagent/conf/omsagent.conf`.
134
+
On a monitored Linux computer, the agent is listed as `omsagent`. `omsconfig` is the Log Analytics agent for the Linux configuration agent that looks for new portal-side configuration every 5 minutes. The new and updated configuration is applied to the agent configuration files located at `/etc/opt/microsoft/omsagent/conf/omsagent.conf`.
The following steps configure setup of the agent for Log Analytics in Azure and Azure Government cloud by using the wrapper script for Linux computers that can communicate directly or through a proxy server to download the agent hosted on GitHub and install the agent.
142
+
The following steps configure setup of the agent for Log Analytics in Azure and Azure Government cloud. A wrapper script is used for Linux computers that can communicate directly or through a proxy server to download the agent hosted on GitHub and install the agent.
144
143
145
-
If your Linux computer needs to communicate through a proxy server to Log Analytics, this configuration can be specified on the command line by including `-p [protocol://][user:password@]proxyhost[:port]`. The *protocol* property accepts `http` or `https`. The `proxyhost` property accepts a fully qualified domain name or IP address of the proxy server.
144
+
If your Linux computer needs to communicate through a proxy server to Log Analytics, this configuration can be specified on the command line by including `-p [protocol://][user:password@]proxyhost[:port]`. The `protocol` property accepts `http` or `https`. The `proxyhost` property accepts a fully qualified domain name or IP address of the proxy server.
146
145
147
146
For example: `https://proxy01.contoso.com:30443`
148
147
@@ -189,7 +188,7 @@ The Log Analytics agent for Linux is provided in a self-extracting and installab
189
188
1. Install the bundle by using the `--install` argument. To onboard to a Log Analytics workspace during installation, provide the `-w <WorkspaceID>` and `-s <workspaceKey>` parameters copied earlier.
190
189
191
190
>[!NOTE]
192
-
> Use the `--upgrade` argument if any dependent packages, such as omi, scx, omsconfig or their older versions, are installed. This would be the case if the System Center Operations Manager agent for Linux is already installed.
191
+
> Use the `--upgrade` argument if any dependent packages, such as omi, scx, omsconfig, or their older versions, are installed. This would be the case if the System Center Operations Manager agent for Linux is already installed.
@@ -198,7 +197,7 @@ The Log Analytics agent for Linux is provided in a self-extracting and installab
198
197
> [!NOTE]
199
198
> The preceding command uses the optional `--skip-docker-provider-install` flag to disable the Container Monitoring data collection because the [Container Monitoring solution](../containers/containers.md) is being retired.
200
199
201
-
1. To configure the Linux agent to install and connect to a Log Analytics workspace through a Log Analytics gateway, run the following command that provides the proxy, workspace ID, and workspace key parameters. This configuration can be specified on the command line by including `-p [protocol://][user:password@]proxyhost[:port]`. The `proxyhost` property accepts a fully qualified domain name or IP address of the Log Analytics gateway server.
200
+
1. To configure the Linux agent to install and connect to a Log Analytics workspace through a Log Analytics gateway, run the following command. It provides the proxy, workspace ID, and workspace key parameters. This configuration can be specified on the command line by including `-p [protocol://][user:password@]proxyhost[:port]`. The `proxyhost` property accepts a fully qualified domain name or IP address of the Log Analytics gateway server.
1. To configure the Linux computer to connect to a Log Analytics workspace in Azure Government cloud, run the following command that provides the workspace ID and primary key copied earlier.
212
+
1. To configure the Linux computer to connect to a Log Analytics workspace in Azure Government cloud, run the following command that provides the workspace ID and primary key copied earlier:
@@ -235,7 +234,7 @@ sudo sh ./omsagent-*.universal.x64.sh --extract
235
234
Upgrading from a previous version, starting with version 1.0.0-47, is supported in each release. Perform the installation with the `--upgrade` parameter to upgrade all components of the agent to the latest version.
236
235
237
236
> [!NOTE]
238
-
> There will be a warning message during the upgrade "docker provider package installation skipped" since `--skip-docker-provider-install` flag is set. If you're installing over an existing omsagent install and want to remove the docker provider, you should first purge the existing installation and then install by using the `--skip-docker-provider-install` flag.
237
+
> The warning message "docker provider package installation skipped" appears during the upgrade because the `--skip-docker-provider-install` flag is set. If you're installing over an existing `omsagent` installation and want to remove the docker provider, purge the existing installation first. Then install by using the `--skip-docker-provider-install` flag.
239
238
240
239
## Cache information
241
240
Data from the Log Analytics agent for Linux is cached on the local machine at *%STATE_DIR_WS%/out_oms_common*.buffer* before it's sent to Azure Monitor. Custom log data is buffered in *%STATE_DIR_WS%/out_oms_blob*.buffer*. The path might be different for some [solutions and data types](https://github.com/microsoft/OMS-Agent-for-Linux/search?utf8=%E2%9C%93&q=+buffer_path&type=).
@@ -248,4 +247,4 @@ The default cache size is 10 MB but can be modified in the [omsagent.conf file](
248
247
249
248
- Review [Managing and maintaining the Log Analytics agent for Windows and Linux](agent-manage.md) to learn about how to reconfigure, upgrade, or remove the agent from the virtual machine.
250
249
- Review [Troubleshooting the Linux agent](agent-linux-troubleshoot.md) if you encounter issues while you're installing or managing the agent.
251
-
- Review [Agent Data Sources](./agent-data-sources.md) to learn about data source configuration.
250
+
- Review [Agent data sources](./agent-data-sources.md) to learn about data source configuration.
Copy file name to clipboardExpand all lines: articles/azure-monitor/agents/data-sources-iis-logs.md
+18-18Lines changed: 18 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,57 +1,57 @@
1
1
---
2
-
title: Collect IIS logs with Log Analytics agent in Azure Monitor
3
-
description: Internet Information Services (IIS) stores user activity in log files that can be collected by Azure Monitor. This article describes how to configure collection of IIS logs and details of the records they create in Azure Monitor.
2
+
title: Collect IIS logs with the Log Analytics agent in Azure Monitor
3
+
description: This article describes how to configure collection of IIS log files that store user activity and the details of the records they create in Azure Monitor.
4
4
ms.topic: conceptual
5
5
ms.date: 03/31/2022
6
6
ms.reviewer: JeffWo
7
7
8
8
---
9
9
10
-
# Collect IIS logs with Log Analytics agent in Azure Monitor
10
+
# Collect IIS logs with the Log Analytics agent in Azure Monitor
11
11
Internet Information Services (IIS) stores user activity in log files that can be collected by the Log Analytics agent and stored in [Azure Monitor Logs](../data-platform.md).

14
14
15
15
> [!IMPORTANT]
16
-
> This article covers collecting IIS logs with the [Log Analytics agent](./log-analytics-agent.md), which **will be deprecated by August 2024**. Please be sure to [migrate to Azure Monitor agent](./azure-monitor-agent-manage.md) before August 2024 to continue ingesting data. See [Collect text logs with Azure Monitor agent (preview)](../agents/data-collection-text-log.md) for details on collecting IIS logs with [Azure Monitor agent](azure-monitor-agent-overview.md).
16
+
> This article covers collecting IIS logs with the [Log Analytics agent](./log-analytics-agent.md), which **will be deprecated by August 2024**. Be sure to [migrate to Azure Monitor Agent](./azure-monitor-agent-manage.md) before August 2024 to continue ingesting data. See [Collect text logs with Azure Monitor Agent (preview)](../agents/data-collection-text-log.md) for details on collecting IIS logs with [Azure Monitor Agent](azure-monitor-agent-overview.md).
17
17
18
-
19
-
## Configuring IIS logs
18
+
## Configure IIS logs
20
19
Azure Monitor collects entries from log files created by IIS, so you must [configure IIS for logging](/previous-versions/orphan-topics/ws.11/hh831775(v=ws.11)).
21
20
22
-
Azure Monitor only supports IIS log files stored in W3C format and does not support custom fields or IIS Advanced Logging. It does not collect logs in NCSA or IIS native format.
23
-
24
-
Configure IIS logs in Azure Monitor from the [Agent configuration menu](../agents/agent-data-sources.md#configure-data-sources) for the Log Analytics agent. There is no configuration required other than selecting **Collect W3C format IIS log files**.
21
+
Azure Monitor only supports IIS log files stored in W3C format and doesn't support custom fields or IIS Advanced Logging. It doesn't collect logs in NCSA or IIS native format.
25
22
23
+
Configure IIS logs in Azure Monitor from the [Agent configuration menu](../agents/agent-data-sources.md#configure-data-sources) for the Log Analytics agent. No configuration is required other than selecting **Collect W3C format IIS log files**.
26
24
27
25
## Data collection
28
-
Azure Monitor collects IIS log entries from each agent each time the log timestamp changes. The log is read every **5 minutes**. If for any reason IIS doesn't update the timestamp before the rollover time when a new file is created, entries will be collected following creation of the new file. The frequency of new file creation is controlled by the **Log File Rollover Schedule** setting for the IIS site, which is once a day by default. If the setting is **Hourly**, Azure Monitor collects the log each hour. If the setting is **Daily**, Azure Monitor collects the log every 24 hours.
26
+
Azure Monitor collects IIS log entries from each agent each time the log timestamp changes. The log is read every 5 minutes. If for any reason IIS doesn't update the timestamp before the rollover time when a new file is created, entries will be collected following creation of the new file.
27
+
28
+
The frequency of new file creation is controlled by the **Log File Rollover Schedule** setting for the IIS site. The setting is once a day by default. If the setting is **Hourly**, Azure Monitor collects the log each hour. If the setting is **Daily**, Azure Monitor collects the log every 24 hours.
29
29
30
30
> [!IMPORTANT]
31
-
> It is recommended to set the **Log File Rollover Schedule** to **Hourly**. If it's set to **Daily**, you may experience spikes in your data since it will only be collected once per day.
31
+
> We recommend that you set **Log File Rollover Schedule** to **Hourly**. If it's set to **Daily**, you might experience spikes in your data because it will be collected only once per day.
32
32
33
33
## IIS log record properties
34
-
IIS log records have a type of **W3CIISLog** and have the properties in the following table:
34
+
IIS log records have a type of **W3CIISLog** and have the properties shown in the following table:
35
35
36
36
| Property | Description |
37
37
|:--- |:--- |
38
38
| Computer |Name of the computer that the event was collected from. |
39
39
| cIP |IP address of the client. |
40
-
| csMethod |Method of the request such as GET or POST. |
40
+
| csMethod |Method of the request, such as GET or POST. |
41
41
| csReferer |Site that the user followed a link from to the current site. |
42
42
| csUserAgent |Browser type of the client. |
43
43
| csUserName |Name of the authenticated user that accessed the server. Anonymous users are indicated by a hyphen. |
44
-
| csUriStem |Target of the request such as a web page. |
44
+
| csUriStem |Target of the request, such as a webpage. |
45
45
| csUriQuery |Query, if any, that the client was trying to perform. |
46
-
| ManagementGroupName |Name of the management group for Operations Manager agents. For other agents, this is AOI-\<workspace ID\>|
46
+
| ManagementGroupName |Name of the management group for Operations Manager agents. For other agents, this name is AOI-\<workspace ID\>.|
47
47
| RemoteIPCountry |Country/region of the IP address of the client. |
48
48
| RemoteIPLatitude |Latitude of the client IP address. |
49
49
| RemoteIPLongitude |Longitude of the client IP address. |
50
50
| scStatus |HTTP status code. |
51
51
| scSubStatus |Substatus error code. |
52
52
| scWin32Status |Windows status code. |
53
53
| sIP |IP address of the web server. |
54
-
| SourceSystem |OpsMgr |
54
+
| SourceSystem |OpsMgr.|
55
55
| sPort |Port on the server the client connected to. |
56
56
| sSiteName |Name of the IIS site. |
57
57
| TimeGenerated |Date and time the entry was logged. |
@@ -60,7 +60,7 @@ IIS log records have a type of **W3CIISLog** and have the properties in the foll
60
60
| csBytes | Number of bytes that the server received. |
61
61
62
62
## Log queries with IIS logs
63
-
The following table provides different examples of log queries that retrieve IIS log records.
63
+
Different examples of log queries that retrieve IIS log records are shown in the following table:
0 commit comments