Skip to content

Commit 5dd3828

Browse files
Merge pull request #220077 from limwainstein/connector-notes
Adding notes about legacy connector deprecation
2 parents 100be50 + c8e8111 commit 5dd3828

File tree

5 files changed

+21
-13
lines changed

5 files changed

+21
-13
lines changed

articles/sentinel/ama-migrate.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -43,18 +43,16 @@ The following tables show gap analyses for the log types that currently rely on
4343
|**Sysmon** | Collection only | Collection only |
4444
|**DNS logs** | [Windows DNS servers via AMA connector](connect-dns-ama.md) (Public preview) | [Windows DNS Server connector](data-connectors-reference.md#windows-dns-server-preview) (Public preview) |
4545

46-
4746
### Linux logs
4847

4948
|Log type / Support |Azure Monitor agent support |Log Analytics agent support |
5049
|---------|---------|---------|
5150
|**Syslog** | Collection only | [Syslog data connector](connect-syslog.md) |
52-
|**Common Event Format (CEF)** | Collection only | [CEF data connector](connect-common-event-format.md) |
51+
|**Common Event Format (CEF)** | [CEF via AMA data connector](connect-cef-ama.md) | [CEF data connector](connect-common-event-format.md) |
5352
|**Sysmon** | Collection only | Collection only |
5453
|**Custom logs** | - | Collection only |
5554
|**Multi-homing** | Collection only | - |
5655

57-
5856
## Recommended migration plan
5957

6058
Each organization will have different metrics of success and internal migration processes. This section provides suggested guidance to consider when migrating from the Log Analytics MMA/OMS agent to the AMA, specifically for Microsoft Sentinel.

articles/sentinel/connect-common-event-format.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,12 +10,13 @@ ms.custom: ignite-fall-2021
1010

1111
# Get CEF-formatted logs from your device or appliance into Microsoft Sentinel
1212

13-
[!INCLUDE [Banner for top of topics](./includes/banner.md)]
14-
1513
[!INCLUDE [reference-to-feature-availability](includes/reference-to-feature-availability.md)]
1614

1715
Many networking and security devices and appliances send their system logs over the Syslog protocol in a specialized format known as Common Event Format (CEF). This format includes more information than the standard Syslog format, and it presents the information in a parsed key-value arrangement. The Log Analytics Agent accepts CEF logs and formats them especially for use with Microsoft Sentinel, before forwarding them on to your Microsoft Sentinel workspace.
1816

17+
> [!IMPORTANT]
18+
> The Log Analytics agent will be [retired on **31 August, 2024**](https://azure.microsoft.com/updates/were-retiring-the-log-analytics-agent-in-azure-monitor-on-31-august-2024/). If you are using the Log Analytics agent in your Microsoft Sentinel deployment, we recommend that you start planning your migration to the AMA. For more information, see [AMA migration for Microsoft Sentinel](ama-migrate.md).
19+
1920
This article describes the process of using CEF-formatted logs to connect your data sources. For information about data connectors that use this method, see [Microsoft Sentinel data connectors reference](data-connectors-reference.md).
2021

2122
There are two main steps to making this connection, that will be explained below in detail:

articles/sentinel/connect-custom-logs.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,14 +10,15 @@ ms.custom: ignite-fall-2021
1010

1111
# Collect data in custom log formats to Microsoft Sentinel with the Log Analytics agent
1212

13-
[!INCLUDE [Banner for top of topics](./includes/banner.md)]
14-
1513
[!INCLUDE [reference-to-feature-availability](includes/reference-to-feature-availability.md)]
1614

1715
Many applications log data to text files instead of standard logging services like Windows Event log or Syslog. You can use the Log Analytics agent to collect data in text files of nonstandard formats from both Windows and Linux computers. Once collected, you can either parse the data into individual fields in your queries or extract the data during collection to individual fields.
1816

1917
This article describes how to connect your data sources to Microsoft Sentinel using custom log formats. For more information about supported data connectors that use this method, see [Data connectors reference](data-connectors-reference.md).
2018

19+
> [!IMPORTANT]
20+
> The Log Analytics agent will be [retired on **31 August, 2024**](https://azure.microsoft.com/updates/were-retiring-the-log-analytics-agent-in-azure-monitor-on-31-august-2024/). If you are using the Log Analytics agent in your Microsoft Sentinel deployment, we recommend that you start planning your migration to the AMA. For more information, see [AMA migration for Microsoft Sentinel](ama-migrate.md).
21+
2122
Learn all about [custom logs in the Azure Monitor documentation](../azure-monitor/agents/data-sources-custom-logs.md).
2223

2324
Similar to Syslog, there are two steps to configuring custom log collection:

articles/sentinel/connect-syslog.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,14 +10,15 @@ ms.custom: ignite-fall-2021
1010

1111
# Collect data from Linux-based sources using Syslog
1212

13-
[!INCLUDE [Banner for top of topics](./includes/banner.md)]
14-
1513
[!INCLUDE [reference-to-feature-availability](includes/reference-to-feature-availability.md)]
1614

1715
**Syslog** is an event logging protocol that is common to Linux. You can use the Syslog daemon built into Linux devices and appliances to collect local events of the types you specify, and have it send those events to Microsoft Sentinel using the **Log Analytics agent for Linux** (formerly known as the OMS agent).
1816

1917
This article describes how to connect your data sources to Microsoft Sentinel using Syslog. For more information about supported connectors for this method, see [Data connectors reference](data-connectors-reference.md).
2018

19+
> [!IMPORTANT]
20+
> The Log Analytics agent will be [retired on **31 August, 2024**](https://azure.microsoft.com/updates/were-retiring-the-log-analytics-agent-in-azure-monitor-on-31-august-2024/). If you are using the Log Analytics agent in your Microsoft Sentinel deployment, we recommend that you start planning your migration to the AMA. For more information, see [AMA migration for Microsoft Sentinel](ama-migrate.md).
21+
2122
## Architecture
2223

2324
When the Log Analytics agent is installed on your VM or appliance, the installation script configures the local Syslog daemon to forward messages to the agent on UDP port 25224. After receiving the messages, the agent sends them to your Log Analytics workspace over HTTPS, where they are ingested into the Syslog table in **Microsoft Sentinel > Logs**.

articles/sentinel/data-connectors-reference.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,9 @@ This article describes how to deploy data connectors in Microsoft Sentinel, list
1414

1515
Some data connectors are deployed only via solutions. For more information, see the [Discover and deploy Microsoft Sentinel out-of-the-box content and solutions](sentinel-solutions-deploy.md). You can also find other, community-built data connectors in the [Microsoft Sentinel GitHub repository](https://github.com/Azure/Azure-Sentinel/tree/master/DataConnectors).
1616

17+
> [!IMPORTANT]
18+
> For connectors that use the Log Analytics agent, the agent will be [retired on **31 August, 2024**](https://azure.microsoft.com/updates/were-retiring-the-log-analytics-agent-in-azure-monitor-on-31-august-2024/). If you are using the Log Analytics agent in your Microsoft Sentinel deployment, we recommend that you start planning your migration to the AMA. For more information, see [AMA migration for Microsoft Sentinel](ama-migrate.md).
19+
1720
## How to use this guide
1821

1922
1. First, locate and select the connector for your product, service, or device in the headings menu to the right.
@@ -699,11 +702,11 @@ Configure eNcore to stream data via TCP to the Log Analytics Agent. This configu
699702
| **Vendor documentation/<br>installation instructions** | [Get a Cyberpion subscription](https://azuremarketplace.microsoft.com/en/marketplace/apps/cyberpion1597832716616.cyberpion)<br>[Integrate Cyberpion security alerts into Microsoft Sentinel](https://www.cyberpion.com/resource-center/integrations/azure-sentinel/) |
700703
| **Supported by** | [Cyberpion](https://www.cyberpion.com/) |
701704

702-
703-
704-
705705
## DNS (Preview)
706706

707+
> [!IMPORTANT]
708+
> The Log Analytics agent will be [retired on **31 August, 2024**](https://azure.microsoft.com/updates/were-retiring-the-log-analytics-agent-in-azure-monitor-on-31-august-2024/). If you are using the Log Analytics agent in your Microsoft Sentinel deployment, we recommend that you start planning your migration to the AMA. For more information, see [AMA migration for Microsoft Sentinel](ama-migrate.md).
709+
707710
**See [Windows DNS Events via AMA (Preview)](#windows-dns-events-via-ama-preview) or [Windows DNS Server (Preview)](#windows-dns-server-preview).**
708711

709712
## Dynamics 365
@@ -1565,6 +1568,9 @@ If a longer timeout duration is required, consider upgrading to an [App Service
15651568
15661569
## Security events via Legacy Agent (Windows)
15671570
1571+
> [!IMPORTANT]
1572+
> The Log Analytics agent will be [retired on **31 August, 2024**](https://azure.microsoft.com/updates/were-retiring-the-log-analytics-agent-in-azure-monitor-on-31-august-2024/). If you are using the Log Analytics agent in your Microsoft Sentinel deployment, we recommend that you start planning your migration to the AMA. For more information, see [AMA migration for Microsoft Sentinel](ama-migrate.md).
1573+
15681574
| Connector attribute | Description |
15691575
| --- | --- |
15701576
| **Data ingestion method** | **Azure service-to-service integration: <br>[Log Analytics agent-based connections](connect-azure-windows-microsoft-services.md?tabs=LAA#windows-agent-based-connections) (Legacy)** |
@@ -1832,7 +1838,8 @@ Follow the instructions to obtain the credentials.
18321838
18331839
## Windows DNS Server (Preview)
18341840
1835-
This connector uses the legacy agent. We recommend that you use the DNS over AMA connector above.
1841+
> [!IMPORTANT]
1842+
> The Log Analytics agent will be [retired on **31 August, 2024**](https://azure.microsoft.com/updates/were-retiring-the-log-analytics-agent-in-azure-monitor-on-31-august-2024/). If you are using the Log Analytics agent in your Microsoft Sentinel deployment, we recommend that you start planning your migration to the AMA. For more information, see [AMA migration for Microsoft Sentinel](ama-migrate.md).
18361843
18371844
| Connector attribute | Description |
18381845
| --- | --- |

0 commit comments

Comments
 (0)