Skip to content

Commit 1aeee03

Browse files
authored
Merge pull request #12525 from bandersmsft/master
LA-containers update
2 parents 735b032 + ee2ef61 commit 1aeee03

File tree

7 files changed

+109
-217
lines changed

7 files changed

+109
-217
lines changed

articles/log-analytics/TOC.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@
55
# Get Started
66
## [Sign up for Log Analytics](log-analytics-get-started.md)
77
## [Manage access](log-analytics-manage-access.md)
8-
## [Proxy and firewall](log-analytics-proxy-firewall.md)
98
## [Usage data](log-analytics-usage.md)
109
## [Log Analytics FAQ](log-analytics-faq.md)
1110
## [Service providers](log-analytics-service-providers.md)
@@ -36,7 +35,7 @@
3635
### [Log searches overview](log-analytics-log-searches.md)
3736
### [Search reference](log-analytics-search-reference.md)
3837
#### [Regular expressions](log-analytics-log-searches-regex.md)
39-
### [Take action from search results](log-analytics-log-search-takeaction.md)
38+
### [Take action from search results](log-analytics-log-search-takeaction.md)
4039
### [Computer groups](log-analytics-computer-groups.md)
4140
## Analyze data
4241
### [Dashboards](log-analytics-dashboards.md)

articles/log-analytics/log-analytics-containers.md

Lines changed: 32 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ ms.workload: na
1212
ms.tgt_pltfrm: na
1313
ms.devlang: na
1414
ms.topic: article
15-
ms.date: 04/24/2017
15+
ms.date: 05/08/2017
1616
ms.author: banders
1717

1818
---
@@ -39,11 +39,10 @@ There are a few ways to install and use Docker with OMS:
3939

4040
You can review the supported Docker and Linux operating system versions for your container host on [GitHub](https://github.com/Microsoft/OMS-docker).
4141

42-
If you have a Kubernetes cluster using the Azure Container Service, learn more at [Monitor an Azure Container Service cluster with Microsoft Operations Management Suite (OMS)](../container-service/container-service-kubernetes-oms.md).
43-
44-
If you have an Azure Container Service DC/OS cluster, learn more at [Monitor an Azure Container Service DC/OS cluster with Operations Management Suite](../container-service/container-service-monitoring-oms.md).
45-
46-
Review the [Docker Engine on Windows](https://docs.microsoft.com/virtualization/windowscontainers/manage-docker/configure-docker-daemon) article for additional information about how to install and configure your Docker Engines on computers running Windows.
42+
- If you have a Kubernetes cluster using the Azure Container Service, learn more at [Monitor an Azure Container Service cluster with Microsoft Operations Management Suite (OMS)](../container-service/container-service-kubernetes-oms.md).
43+
- If you have an Azure Container Service DC/OS cluster, learn more at [Monitor an Azure Container Service DC/OS cluster with Operations Management Suite](../container-service/container-service-monitoring-oms.md).
44+
- If you use containers with Service Fabric, learn more at [Overview of Azure Service Fabric ](../service-fabric/service-fabric-overview.md).
45+
- Review the [Docker Engine on Windows](https://docs.microsoft.com/virtualization/windowscontainers/manage-docker/configure-docker-daemon) article for additional information about how to install and configure your Docker Engines on computers running Windows.
4746

4847
> [!IMPORTANT]
4948
> Docker must be running **before** you install the [OMS Agent for Linux](log-analytics-linux-agents.md) on your container hosts. If you've already installed the agent before installing Docker, you'll need to reinstall the OMS Agent for Linux. For more information about Docker, see the [Docker website](https://www.docker.com).
@@ -54,15 +53,23 @@ You need the following settings configured on your container hosts before you ca
5453

5554
## Configure settings for a Linux container host
5655

56+
Supported Linux versions:
57+
58+
- Docker 1.11 thru 1.13
59+
- Docker CE and EE v17.03
60+
61+
5762
The following x64 Linux distributions are supported as container hosts:
5863

5964
- Ubuntu 14.04 LTS, 16.04 LTS
6065
- CoreOS(stable)
6166
- Amazon Linux 2016.09.0
6267
- openSUSE 13.2
63-
- CentOS 7
68+
- openSUSE LEAP 42.2
69+
- CentOS 7.2, 7.3
6470
- SLES 12
65-
- RHEL 7.2
71+
- RHEL 7.2, 7.3
72+
6673

6774
After you've installed Docker, use the following settings for your container host to configure the agent for use with Docker. You'll need your [OMS workspace ID and key](log-analytics-linux-agents.md).
6875

@@ -90,43 +97,43 @@ If you previously used the directly-installed agent and want to instead use an a
9097
### Docker versions supported on Windows
9198

9299
- Docker 1.12 – 1.13
100+
- Docker 17.03.0 [stable]
93101

94102
### Preparation before installing agents
95103

96104
Before you install agents on computers running Windows, you need to configure the Docker service. The configuration allows the Windows agent or the Log Analytics virtual machine extension to use the Docker TCP socket so that the agents can access the Docker daemon remotely and to capture data for monitoring.
97105

98-
For more information about configuring the Docker daemon with Windows, see [Docker Engine on Windows](https://docs.microsoft.com/virtualization/windowscontainers/manage-docker/configure-docker-daemon).
99-
100106
#### To start Docker and verify its configuration
101107

102-
1. In Windows PowerShell, enable TCP pipe and named pipe.
108+
There are steps needed to set up TCP named pipe for Windows Server:
109+
110+
1. In Windows PowerShell, enable TCP pipe and named pipe.
103111

104112
```
105113
Stop-Service docker
106114
dockerd --unregister-service
107-
dockerd -H npipe:// -H 0.0.0.0:2375 --register-service
115+
dockerd --register-service -H npipe:// -H 0.0.0.0:2375
108116
Start-Service docker
109117
```
110118
111-
2. Verify your configuration with netstat. You should see port 2375.
119+
2. Configure Docker with the configuration file for TCP pipe and named pipe. The configuration file is located at C:\ProgramData\docker\config\daemon.json.
120+
121+
In the daemon.json file, you will need the following:
112122
113123
```
114-
PS C:\Users\User1> netstat -a | sls 2375
115-
116-
TCP 127.0.0.1:2375 Win2016TP5:0 LISTENING
117-
TCP 127.0.0.1:2375 Win2016TP5:49705 ESTABLISHED
118-
TCP 127.0.0.1:2375 Win2016TP5:49706 ESTABLISHED
119-
TCP 127.0.0.1:2375 Win2016TP5:49707 ESTABLISHED
120-
TCP 127.0.0.1:2375 Win2016TP5:49708 ESTABLISHED
121-
TCP 127.0.0.1:49705 Win2016TP5:2375 ESTABLISHED
122-
TCP 127.0.0.1:49706 Win2016TP5:2375 ESTABLISHED
123-
TCP 127.0.0.1:49707 Win2016TP5:2375 ESTABLISHED
124-
TCP 127.0.0.1:49708 Win2016TP5:2375 ESTABLISHED
124+
{
125+
"hosts": ["tcp://0.0.0.0:2375", "npipe://"]
126+
}
125127
```
126128
129+
For more information about the Docker daemon configuration used with Windows Containers, see [Docker Engine on Windows](https://docs.microsoft.com/virtualization/windowscontainers/manage-docker/configure-docker-daemon).
130+
131+
127132
### Install Windows agents
128133
129-
To enable Windows and Hyper-V container monitoring, install agents on Windows computers that are container hosts. For computers running Windows in your on-premises environment, see [Connect Windows computers to Log Analytics](log-analytics-windows-agents.md). For virtual machines running in Azure, connect them to Log Analytics using the [virtual machine extension](log-analytics-azure-vm-extension.md).
134+
To enable Windows and Hyper-V container monitoring, install agents on Windows computers that are container hosts. For computers running Windows in your on-premises environment, see [Connect Windows computers to Log Analytics](log-analytics-windows-agents.md). For virtual machines running in Azure, connect them to Log Analytics using the [virtual machine extension](log-analytics-azure-vm-extension.md).
135+
136+
You can monitor Windows containers running on Service Fabric. However, only [virtual machines running in Azure](log-analytics-azure-vm-extension.md) and [computers running Windows in your on-premises environment](log-analytics-windows-agents.md) are currently supported for Service Fabric.
130137
131138
To verify that the Containers solution is set correctly:
132139
Lines changed: 1 addition & 177 deletions
Original file line numberDiff line numberDiff line change
@@ -1,179 +1,3 @@
11
---
2-
title: Configure proxy and firewall settings in Azure Log Analytics | Microsoft Docs
3-
description: Configure proxy and firewall settings when your agents or OMS services need to use specific ports.
4-
services: log-analytics
5-
documentationcenter: ''
6-
author: bandersmsft
7-
manager: carmonm
8-
editor: ''
9-
ms.assetid: b55ebd80-efd4-4220-971b-c18aea1b1ab2
10-
ms.service: log-analytics
11-
ms.workload: na
12-
ms.tgt_pltfrm: na
13-
ms.devlang: na
14-
ms.topic: get-started-article
15-
ms.date: 04/12/2017
16-
ms.author: banders;magoedte
17-
2+
redirect_url: /azure/log-analytics/log-analytics-windows-agents
183
---
19-
# Configure proxy and firewall settings in Log Analytics
20-
Actions needed to configure proxy and firewall settings for Log Analytics differ for the type of agents that you are using. Review the following sections for the type of agent that you use.
21-
22-
## Settings for the OMS Gateway
23-
24-
If your agents do not have Internet access, they can instead send their data using your own network resources to the OMS Gateway. The Gateway collects their data and sends it to the OMS service on their behalf.
25-
26-
Configure agents that communicate with the OMS Gateway using its fully qualified domain name and custom port number.
27-
28-
The OMS Gateway needs Internet access. Use the same proxy server or firewall settings for the OMS Gateway that you would for the type of agents you have. For more information about the OMS Gateway, see [Connect computers and devices to OMS using the OMS Gateway](log-analytics-oms-gateway.md).
29-
30-
## Configure settings with the Microsoft Monitoring Agent
31-
For the Microsoft Monitoring Agent to connect to and register with the OMS service, it must have access to the port number of your domains and the URLs. If you use a proxy server for communication between the agent and the OMS service, you’ll need to ensure that the appropriate resources are accessible. If you use a firewall to restrict access to the Internet, you need to configure your firewall to permit access to OMS. The following tables list the ports that OMS needs.
32-
33-
| **Agent Resource** | **Ports** | **Bypass HTTPS inspection** |
34-
| --- | --- | --- |
35-
| \*.ods.opinsights.azure.com |443 |Yes |
36-
| \*.oms.opinsights.azure.com |443 |Yes |
37-
| \*.blob.core.windows.net |443 |Yes |
38-
| \*.azure-automation.net |443 |Yes |
39-
40-
You can use the following procedure to configure proxy settings for the Microsoft Monitoring Agent using Control Panel. You'll need to use the procedure for each server. If you have many servers that you need to configure, you might find it easier to use a script to automate this process. If so, see the next procedure [To configure proxy settings for the Microsoft Monitoring Agent using a script](#to-configure-proxy-settings-for-the-microsoft-monitoring-agent-using-a-script).
41-
42-
### To configure proxy settings for the Microsoft Monitoring Agent using Control Panel
43-
1. Open **Control Panel**.
44-
2. Open **Microsoft Monitoring Agent**.
45-
3. Click the **Proxy Settings** tab.<br>
46-
![proxy settings tab](./media/log-analytics-proxy-firewall/proxy-direct-agent-proxy.png)
47-
4. Select **Use a proxy server** and type the URL and port number, if one is needed, similar to the example shown. If your proxy server requires authentication, type the username and password to access the proxy server.
48-
49-
Use the following procedure to create a PowerShell script that you can run to set the proxy settings for each agent that connects directly to servers.
50-
51-
### To configure proxy settings for the Microsoft Monitoring Agent using a script
52-
Copy the following sample, update it with information specific to your environment, save it with a PS1 file name extension, and then run the script on each computer that connects directly to the OMS service.
53-
54-
param($ProxyDomainName="http://proxy.contoso.com:80", $cred=(Get-Credential))
55-
56-
# First we get the Health Service configuration object. We need to determine if we
57-
#have the right update rollup with the API we need. If not, no need to run the rest of the script.
58-
$healthServiceSettings = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
59-
60-
$proxyMethod = $healthServiceSettings | Get-Member -Name 'SetProxyInfo'
61-
62-
if (!$proxyMethod)
63-
{
64-
Write-Output 'Health Service proxy API not present, will not update settings.'
65-
return
66-
}
67-
68-
Write-Output "Clearing proxy settings."
69-
$healthServiceSettings.SetProxyInfo('', '', '')
70-
71-
$ProxyUserName = $cred.username
72-
73-
Write-Output "Setting proxy to $ProxyDomainName with proxy username $ProxyUserName."
74-
$healthServiceSettings.SetProxyInfo($ProxyDomainName, $ProxyUserName, $cred.GetNetworkCredential().password)
75-
76-
77-
## Configure settings with Operations Manager
78-
For an Operations Manager management group to connect to and register with the OMS service, it must have access to the port numbers of your domains and URLs. If you use a proxy server for communication between the Operations Manager management server and the OMS service, you’ll need to ensure that the appropriate resources are accessible. If you use a firewall to restrict access to the Internet, you need to configure your firewall to permit access to OMS. Even if an Operations Manager management server is not behind a proxy server, its agents might be. In this case, the proxy server should be configured in the same manner as agents are in order to enable and allow Security and Log Management solution data to get sent to the OMS web service.
79-
80-
In order for Operations Manager agents to communicate with the OMS service, your Operations Manager infrastructure (including agents) should have the correct proxy settings and version. The proxy setting for agents is specified in the Operations Manager console. Your version should be one of the following:
81-
82-
* Operations Manager 2012 SP1 Update Rollup 7 or later
83-
* Operations Manager 2012 R2 Update Rollup 3 or later
84-
85-
The following tables list the ports related to these tasks.
86-
87-
> [!NOTE]
88-
> Some of the following resources mention Advisor and Operational Insights, both were previous versions of OMS. However, the listed resources will change in the future.
89-
>
90-
>
91-
92-
Here's a list of agent resources and ports:<br>
93-
94-
| **Agent resource** | **Ports** |
95-
| --- | --- |
96-
| \*.ods.opinsights.azure.com |443 |
97-
| \*.oms.opinsights.azure.com |443 |
98-
| \*.blob.core.windows.net/\* |443 |
99-
100-
<br>
101-
Here's a list of management server resources and ports:<br>
102-
103-
| **Management server resource** | **Ports** | **Bypass HTTPS inspection** |
104-
| --- | --- | --- |
105-
| service.systemcenteradvisor.com |443 | |
106-
| \*.service.opinsights.azure.com |443 | |
107-
| \*.blob.core.windows.net |443 |Yes |
108-
| \*.ods.opinsights.azure.com |443 |Yes |
109-
| \*.azure-automation.net |443 |Yes |
110-
111-
<br>
112-
Here's a list of OMS and Operations Manager console resources and ports.<br>
113-
114-
| **OMS and Operations Manager console resource** | **Ports** |
115-
| --- | --- |
116-
| service.systemcenteradvisor.com |443 |
117-
| \*.service.opinsights.azure.com |443 |
118-
| \*.live.com |Port 80 and 443 |
119-
| \*.microsoft.com |Port 80 and 443 |
120-
| \*.microsoftonline.com |Port 80 and 443 |
121-
| \*.mms.microsoft.com |Port 80 and 443 |
122-
| login.windows.net |Port 80 and 443 |
123-
124-
<br>
125-
126-
Use the following procedures to register your Operations Manager management group with the OMS service. If you are having communication problems between the management group and the OMS service, use the validation procedures to troubleshoot data transmission to the OMS service.
127-
128-
### To request exceptions for the OMS service endpoints
129-
1. Use the information from the first table presented previously to ensure that the resources needed for the Operations Manager management server are accessible through any firewalls you might have.
130-
2. Use the information from the second table presented previously to ensure that the resources needed for the Operations console in Operations Manager and OMS are accessible through any firewalls you might have.
131-
3. If you use a proxy server with Internet Explorer, ensure that it is configured and works correctly. To verify, you can open a secure web connection (HTTPS), for example [https://bing.com](https://bing.com). If the secure web connection doesn’t work in a browser, it probably won’t work in the Operations Manager management console with web services in the cloud.
132-
133-
### To configure the proxy server in the Operations Manager console
134-
1. Open the Operations Manager console and select the **Administration** workspace.
135-
2. Expand **Operational Insights**, and then select **Operational Insights Connection**.<br>
136-
![Operations Manager OMS Connection](./media/log-analytics-proxy-firewall/proxy-om01.png)
137-
3. In the OMS Connection view, click **Configure Proxy Server**.<br>
138-
![Operations Manager OMS Connection Configure Proxy Server](./media/log-analytics-proxy-firewall/proxy-om02.png)
139-
4. In Operational Insights Settings Wizard: Proxy Server, select **Use a proxy server to access the Operational Insights Web Service**, and then type the URL with the port number, for example, **http://myproxy:80**.<br>
140-
![Operations Manager OMS proxy address](./media/log-analytics-proxy-firewall/proxy-om03.png)
141-
142-
### To specify credentials if the proxy server requires authentication
143-
Proxy server credentials and settings need to propagate to managed computers that will report to OMS. Those servers should be in the *Microsoft System Center Advisor Monitoring Server Group*. Credentials are encrypted in the registry of each server in the group.
144-
145-
1. Open the Operations Manager console and select the **Administration** workspace.
146-
2. Under **RunAs Configuration**, select **Profiles**.
147-
3. Open the **System Center Advisor Run As Profile Proxy** profile.<br>
148-
![image of the System Center Advisor Run As Proxy profile](./media/log-analytics-proxy-firewall/proxy-proxyacct1.png)
149-
4. In the Run As Profile Wizard, click **Add** to use a Run As account. You can create a new Run As account or use an existing account. This account needs to have sufficient permissions to pass through the proxy server.<br>
150-
![image of the Run As Profile Wizard](./media/log-analytics-proxy-firewall/proxy-proxyacct2.png)
151-
5. To set the account to manage, choose **A selected class, group, or object** to open the Object Search box.<br>
152-
![image of the Run As Profile Wizard](./media/log-analytics-proxy-firewall/proxy-proxyacct2-1.png)
153-
6. Search for then select **Microsoft System Center Advisor Monitoring Server Group**.<br>
154-
![image of the Object Search box](./media/log-analytics-proxy-firewall/proxy-proxyacct3.png)
155-
7. Click **OK** to close the Add a Run As account box.<br>
156-
![image of the Run As Profile Wizard](./media/log-analytics-proxy-firewall/proxy-proxyacct4.png)
157-
8. Complete the wizard and save the changes.<br>
158-
![image of the Run As Profile Wizard](./media/log-analytics-proxy-firewall/proxy-proxyacct5.png)
159-
160-
### To validate that OMS management packs are downloaded
161-
If you've added solutions to OMS, you can view them in the Operations Manager console as management packs under **Administration**. Search for *System Center Advisor* to quickly find them.<br>
162-
![management packs downloaded](./media/log-analytics-proxy-firewall/proxy-mpdownloaded.png) <br>
163-
Or, you can also check for OMS management packs by using the following Windows PowerShell command in the Operations Manager management server:
164-
165-
```
166-
Get-ScomManagementPack | where {$_.DisplayName -match 'Advisor'} | select Name,DisplayName,Version,KeyToken
167-
```
168-
169-
### To validate that Operations Manager is sending data to the OMS service
170-
1. In the Operations Manager management server, open Performance Monitor (perfmon.exe), and select **Performance Monitor**.
171-
2. Click **Add**, and then select **Health Service Management Groups**.
172-
3. Add all the counters that start with **HTTP**.<br>
173-
![add counters](./media/log-analytics-proxy-firewall/proxy-sendingdata1.png)
174-
4. If your Operations Manager configuration is good, you will see activity for Health Service Management counters for events and other data items, based on the management packs that you added in OMS and the configured log collection policy.<br>
175-
![Performance Monitor showing activity](./media/log-analytics-proxy-firewall/proxy-sendingdata2.png)
176-
177-
## Next steps
178-
* [Add Log Analytics solutions from the Solutions Gallery](log-analytics-add-solutions.md) to add functionality and gather data.
179-
* Get familiar with [log searches](log-analytics-log-searches.md) to view detailed information gathered by solutions.

0 commit comments

Comments
 (0)