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: sdk/monitor/azure-monitor-ingestion/README.md
+8-16Lines changed: 8 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,8 +2,7 @@
2
2
3
3
The Azure Monitor Ingestion client library is used to send custom logs to [Azure Monitor][azure_monitor_overview].
4
4
5
-
This library allows you to send data from virtually any source to supported built-in tables or to custom tables
6
-
that you create in Log Analytics workspace. You can even extend the schema of built-in tables with custom columns.
5
+
This library allows you to send data from virtually any source to supported built-in tables or to custom tables that you create in Log Analytics workspace. You can even extend the schema of built-in tables with custom columns.
7
6
8
7
**Resources:**
9
8
@@ -24,7 +23,7 @@ _Azure SDK Python packages support for Python 2.7 has ended on 01 January 2022.
24
23
25
24
- Python 3.6 or later
26
25
- An [Azure subscription][azure_subscription]
27
-
- An [Azure Log Analytics workspace][azure_monitor_create_using_portal].
26
+
- An [Azure Log Analytics workspace][azure_monitor_create_using_portal]
28
27
- A [Data Collection Endpoint][data_collection_endpoint]
29
28
- A [Data Collection Rule][data_collection_rule]
30
29
@@ -36,7 +35,6 @@ Install the Azure Monitor Ingestion client library for Python with [pip][pip]:
36
35
pip install azure-monitor-ingestion
37
36
```
38
37
39
-
40
38
### Create the client
41
39
42
40
An authenticated client is required to upload Logs to Azure Monitor. The library includes both synchronous and asynchronous forms of the clients. To authenticate, create an instance of a token credential. Use that instance when creating a `LogsIngestionClient`. The following examples use `DefaultAzureCredential` from the [azure-identity](https://pypi.org/project/azure-identity/) package.
Data Collection Endpoints (DCEs) allow you to uniquely configure ingestion settings for Azure Monitor. [This
77
-
article][data_collection_endpoint] provides an overview of data collection endpoints including their contents and
78
-
structure and how you can create and work with them.
74
+
Data Collection Endpoints (DCEs) allow you to uniquely configure ingestion settings for Azure Monitor. [This article][data_collection_endpoint] provides an overview of data collection endpoints including their contents and structure and how you can create and work with them.
79
75
80
76
### Data Collection Rule
81
77
82
-
Data collection rules (DCR) define data collected by Azure Monitor and specify how and where that data should be sent or
83
-
stored. The REST API call must specify a DCR to use. A single DCE can support multiple DCRs, so you can specify a
84
-
different DCR for different sources and target tables.
78
+
Data collection rules (DCR) define data collected by Azure Monitor and specify how and where that data should be sent or stored. The REST API call must specify a DCR to use. A single DCE can support multiple DCRs, so you can specify a different DCR for different sources and target tables.
85
79
86
-
The DCR must understand the structure of the input data and the structure of the target table. If the two don't match,
87
-
it can use a transformation to convert the source data to match the target table. You may also use the transform to
88
-
filter source data and perform any other calculations or conversions.
80
+
The DCR must understand the structure of the input data and the structure of the target table. If the two don't match, it can use a transformation to convert the source data to match the target table. You may also use the transform to filter source data and perform any other calculations or conversions.
89
81
90
82
For more details, refer to [Data collection rules in Azure Monitor](https://docs.microsoft.com/azure/azure-monitor/essentials/data-collection-rule-overview).
91
83
92
84
### Log Analytics Workspace Tables
93
85
94
-
Custom logs can send data to any custom table that you create and to certain built-in tables in your Log Analytics
95
-
workspace. The target table must exist before you can send data to it. The following built-in tables are currently supported:
86
+
Custom logs can send data to any custom table that you create and to certain built-in tables in your Log Analytics workspace. The target table must exist before you can send data to it. The following built-in tables are currently supported:
0 commit comments