Skip to content

Commit 2534267

Browse files
authored
Prepare DCR based Logstash doc for new plugin version
1 parent df993fe commit 2534267

File tree

1 file changed

+32
-2
lines changed

1 file changed

+32
-2
lines changed

articles/sentinel/connect-logstash-data-connection-rules.md

Lines changed: 32 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ The Logstash engine is composed of three components:
4141
- Output plugins: Customized sending of collected and processed data to various destinations.
4242

4343
> [!NOTE]
44-
> - Microsoft supports only the Microsoft Sentinel-provided Logstash output plugin discussed here. The current plugin is named **[microsoft-sentinel-log-analytics-logstash-output-plugin](https://github.com/Azure/Azure-Sentinel/tree/master/DataConnectors/microsoft-sentinel-log-analytics-logstash-output-plugin)**, v1.1.0. You can [open a support ticket](https://portal.azure.com/#create/Microsoft.Support) for any issues regarding the output plugin.
44+
> - Microsoft supports only the Microsoft Sentinel-provided Logstash output plugin discussed here. The current plugin is named **[microsoft-sentinel-log-analytics-logstash-output-plugin](https://github.com/Azure/Azure-Sentinel/tree/master/DataConnectors/microsoft-sentinel-log-analytics-logstash-output-plugin)**, v1.1.3. You can [open a support ticket](https://portal.azure.com/#create/Microsoft.Support) for any issues regarding the output plugin.
4545
>
4646
> - Microsoft does not support third-party Logstash output plugins for Microsoft Sentinel, or any other Logstash plugin or component of any type.
4747
>
@@ -69,7 +69,7 @@ The Microsoft Sentinel output plugin for Logstash sends JSON-formatted data to y
6969
- Install a supported version of Logstash. The plugin supports the following Logstash versions:
7070
- 7.0 - 7.17.13
7171
- 8.0 - 8.9
72-
- 8.11 - 8.13
72+
- 8.11 - 8.15
7373

7474
> [!NOTE]
7575
> If you use Logstash 8, we recommended that you [disable ECS in the pipeline](https://www.elastic.co/guide/en/logstash/8.4/ecs-ls.html).
@@ -459,6 +459,36 @@ The following table lists the firewall requirements for scenarios where Azure vi
459459
| Microsoft Azure operated by 21Vianet |https://login.chinacloudapi.cn |Authorization server (the Microsoft identity platform)|Port 443 |Outbound|Yes |
460460
| Microsoft Azure operated by 21Vianet |Replace '.com' above with '.cn' | Data collection Endpoint|Port 443 |Outbound|Yes |
461461

462+
## Plugin-versions
463+
#### 1.1.3
464+
- Replace the library rest-client used for connecting with Azure to excon.
465+
466+
#### 1.1.1
467+
- Support China and US Government Azure sovereign clouds.
468+
469+
#### 1.1.0
470+
- Allow setting different proxy values for api connections.
471+
- Upgrade version for ingestion api to 2023-01-01.
472+
- Rename the plugin to microsoft-sentinel-log-analytics-logstash-output-plugin.
473+
474+
#### 1.0.0
475+
- Initial release for output plugin for logstash to Microsoft Sentinel. This is done with the Log Analytics DCR based API.
476+
## Known issues
477+
478+
When using Logstash installed on a docker image of Lite Ubuntu the following warning may appear:
479+
```
480+
java.lang.RuntimeException: getprotobyname_r failed
481+
```
482+
To resolve it, install netbase within your docker file using the following commands:
483+
```bash
484+
USER root
485+
RUN apt install netbase -y
486+
```
487+
More information can be found [here.](https://github.com/elastic/logstash/issues/13703)
488+
489+
If your environment's event rate is low in comparison to the number of allocated Logstash workers, it's recommended to increase the value of plugin_flush_interval to 60 or more. This change will allow each worker to batch more events before uploading to the DCE. You can monitor the ingestion payload using [DCR metrics.](/azure/azure-monitor/essentials/data-collection-monitor#dcr-metrics)
490+
More information regarding plugin_flush_interval can be found on the table of Optional Configuration [above.](#optional-configuration)
491+
462492
## Limitations
463493

464494
- Ingestion into standard tables is limited only to [standard tables supported for custom logs ingestion](data-transformation.md#data-transformation-support-for-custom-data-connectors).

0 commit comments

Comments
 (0)