Skip to content

Commit

Permalink
Fix urls (#39260)
Browse files Browse the repository at this point in the history
  • Loading branch information
xiangyan99 authored Jan 17, 2025
1 parent dfd8d35 commit 7385768
Show file tree
Hide file tree
Showing 6 changed files with 31 additions and 31 deletions.
4 changes: 2 additions & 2 deletions sdk/monitor/azure-monitor-ingestion/samples/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,8 +87,8 @@ To learn more about Azure Monitor, see the [Azure Monitor service documentation]
<!-- External links -->
[azure_identity]: https://pypi.org/project/azure-identity/
[azure_identity_default_azure_credential]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/identity/azure-identity#defaultazurecredential
[azure_monitor_create_using_portal]: https://docs.microsoft.com/azure/azure-monitor/logs/quick-create-workspace
[azure_monitor_docs]: https://docs.microsoft.com/azure/azure-monitor/
[azure_monitor_create_using_portal]: https://learn.microsoft.com/azure/azure-monitor/logs/quick-create-workspace
[azure_monitor_docs]: https://learn.microsoft.com/azure/azure-monitor/
[azure_monitor_logs_ingestion_overview]: https://learn.microsoft.com/azure/azure-monitor/logs/logs-ingestion-api-overview
[azure_subscription]: https://azure.microsoft.com/free/
[data_collection_endpoint]: https://learn.microsoft.com/azure/azure-monitor/essentials/data-collection-endpoint-overview
Expand Down
6 changes: 3 additions & 3 deletions sdk/monitor/azure-monitor-opentelemetry-exporter/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -647,7 +647,7 @@ Please find further examples in the [samples][exporter_samples] directory demons

### Additional documentation

For more extensive documentation on the Azure Monitor service, see the [Azure Monitor documentation][product_docs] on docs.microsoft.com.
For more extensive documentation on the Azure Monitor service, see the [Azure Monitor documentation][product_docs] on learn.microsoft.com.

For detailed overview of OpenTelemetry, visit their [overview](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/overview.md) page.

Expand All @@ -673,13 +673,13 @@ contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additio
[aad_for_ai_docs]: https://learn.microsoft.com/azure/azure-monitor/app/azure-ad-authentication?tabs=python
[api_docs]: https://azure.github.io/azure-sdk-for-python/monitor.html#azure-monitor-opentelemetry-exporter
[exporter_samples]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/monitor/azure-monitor-opentelemetry-exporter/samples
[product_docs]: https://docs.microsoft.com/azure/azure-monitor/overview
[product_docs]: https://learn.microsoft.com/azure/azure-monitor/overview
[azure_sub]: https://azure.microsoft.com/free/
[pip]: https://pypi.org/project/pip/
[pypi]: https://pypi.org/project/azure-monitor-opentelemetry-exporter/
[python]: https://www.python.org/downloads/
[ot_sdk_python]: https://github.com/open-telemetry/opentelemetry-python
[application_insights_namespace]: https://docs.microsoft.com/azure/azure-monitor/app/app-insights-overview#how-do-i-use-application-insights
[application_insights_namespace]: https://learn.microsoft.com/azure/azure-monitor/app/app-insights-overview#how-do-i-use-application-insights
[opentelemetry_spec]: https://opentelemetry.io/
[instrumentation_library]: https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/overview.md#instrumentation-libraries
[log_concept]: https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/overview.md#log-signal
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -59,4 +59,4 @@ $ python sample_properties.py
## Explore the data

After running the applications, data would be available in [Azure](
https://docs.microsoft.com/azure/azure-monitor/app/app-insights-overview#where-do-i-see-my-telemetry)
https://learn.microsoft.com/azure/azure-monitor/app/app-insights-overview#where-do-i-see-my-telemetry)
Original file line number Diff line number Diff line change
Expand Up @@ -58,4 +58,4 @@ $ python sample_views.py
## Explore the data

After running the applications, data would be available in [Azure](
https://docs.microsoft.com/azure/azure-monitor/app/app-insights-overview#where-do-i-see-my-telemetry)
https://learn.microsoft.com/azure/azure-monitor/app/app-insights-overview#where-do-i-see-my-telemetry)
Original file line number Diff line number Diff line change
Expand Up @@ -197,7 +197,7 @@ $ python sample_jaeger.py

### Azure AppConfig Add Config Setting

The following sample assumes that you have setup an Azure App Configuration [Store](https://docs.microsoft.com/azure/azure-app-configuration/quickstart-python).
The following sample assumes that you have setup an Azure App Configuration [Store](https://learn.microsoft.com/azure/azure-app-configuration/quickstart-python).

* Update `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable

Expand All @@ -214,7 +214,7 @@ $ python sample_app_config.py

### Azure Communication Chat Create Client/Thread

The following sample assumes that you have setup an Azure Communication Services [resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
The following sample assumes that you have setup an Azure Communication Services [resource](https://learn.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).

* Update `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable

Expand All @@ -233,7 +233,7 @@ $ python sample_comm_chat.py

### Azure Communication Phone Numbers List Purchased Numbers

The following sample assumes that you have setup an Azure Communication Services [resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
The following sample assumes that you have setup an Azure Communication Services [resource](https://learn.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).

* Update `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable

Expand All @@ -250,7 +250,7 @@ $ python sample_comm_phone.py

### Azure Communication SMS Send Message

The following sample assumes that you have setup an Azure Communication Services [resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
The following sample assumes that you have setup an Azure Communication Services [resource](https://learn.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).

* Update `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable

Expand All @@ -267,7 +267,7 @@ $ python sample_comm_sms.py

### Azure CosmosDb Create Db/Container

The following sample assumes that you have setup Azure CosmosDb [account](https://docs.microsoft.com/azure/cosmos-db/sql/create-cosmosdb-resources-portal).
The following sample assumes that you have setup Azure CosmosDb [account](https://learn.microsoft.com/azure/cosmos-db/sql/create-cosmosdb-resources-portal).

* Update `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable
* Update `ACCOUNT_URI` environment variable
Expand All @@ -286,7 +286,7 @@ $ python sample_cosmos.py

### Azure EventHub Send EventData

The following sample assumes that you have setup an Azure EventHubs namespace and [EventHub](https://docs.microsoft.com/azure/event-hubs/event-hubs-create).
The following sample assumes that you have setup an Azure EventHubs namespace and [EventHub](https://learn.microsoft.com/azure/event-hubs/event-hubs-create).

* Update `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable
* Update `EVENT_HUB_CONN_STR` environment variable
Expand All @@ -305,7 +305,7 @@ $ python sample_event_hub.py

### Azure EventHub Blob Storage Checkpoint Store

The following sample assumes that you have setup an Azure EventHubs namespace, [EventHub](https://docs.microsoft.com/azure/event-hubs/event-hubs-create) and Azure Blob [storage](https://docs.microsoft.com/azure/storage/blobs/storage-quickstart-blobs-portal).
The following sample assumes that you have setup an Azure EventHubs namespace, [EventHub](https://learn.microsoft.com/azure/event-hubs/event-hubs-create) and Azure Blob [storage](https://learn.microsoft.com/azure/storage/blobs/storage-quickstart-blobs-portal).

* Update `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable
* Update `EVENT_HUB_CONN_STR` environment variable
Expand All @@ -325,7 +325,7 @@ $ python sample_blob_checkpoint.py

### Azure EventGrid Send Event

The following sample assumes that you have setup an Azure Event Grid [Topic](https://docs.microsoft.com/azure/event-grid/custom-event-quickstart-portal).
The following sample assumes that you have setup an Azure Event Grid [Topic](https://learn.microsoft.com/azure/event-grid/custom-event-quickstart-portal).

* Update `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable
* Update `EG_ACCESS_KEY` environment variable
Expand All @@ -344,7 +344,7 @@ $ python sample_event_grid.py

### Azure Form Recognizer Analyze Document

The following sample assumes that you have setup an Azure Form Recognizer [Resource](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account).
The following sample assumes that you have setup an Azure Form Recognizer [Resource](https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account).

* Update `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable

Expand All @@ -361,7 +361,7 @@ $ python sample_form_recognizer.py

### Azure KeyVault Create Certificate

The following sample assumes that you have setup an Azure Key Vault [resource](https://docs.microsoft.com/azure/key-vault/general/quick-create-portal) and a service [principal](https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal) for authentication.
The following sample assumes that you have setup an Azure Key Vault [resource](https://learn.microsoft.com/azure/key-vault/general/quick-create-portal) and a service [principal](https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal) for authentication.

* Update `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable

Expand All @@ -380,7 +380,7 @@ $ python sample_key_cert.py

### Azure KeyVault Set Secret

The following sample assumes that you have setup an Azure Key Vault [resource](https://docs.microsoft.com/azure/key-vault/general/quick-create-portal) and a service [principal](https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal) for authentication.
The following sample assumes that you have setup an Azure Key Vault [resource](https://learn.microsoft.com/azure/key-vault/general/quick-create-portal) and a service [principal](https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal) for authentication.

* Update `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable

Expand All @@ -399,7 +399,7 @@ $ python sample_key_secret.py

### Azure KeyVault Create Keys

The following sample assumes that you have setup an Azure Key Vault [resource](https://docs.microsoft.com/azure/key-vault/general/quick-create-portal) and a service [principal](https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal) for authentication.
The following sample assumes that you have setup an Azure Key Vault [resource](https://learn.microsoft.com/azure/key-vault/general/quick-create-portal) and a service [principal](https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal) for authentication.

* Update `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable

Expand All @@ -418,7 +418,7 @@ $ python sample_key_keys.py

### Azure Service Bus Send

The following sample assumes that you have setup an Azure Service Bus [namespace](https://docs.microsoft.com/azure/service-bus-messaging/service-bus-quickstart-portal).
The following sample assumes that you have setup an Azure Service Bus [namespace](https://learn.microsoft.com/azure/service-bus-messaging/service-bus-quickstart-portal).

* Update `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable
* Update `SERVICE_BUS_CONN_STR` environment variable
Expand All @@ -437,7 +437,7 @@ $ python sample_servicebus_send.py

### Azure Service Bus Receive

The following sample assumes that you have setup an Azure Service Bus [namespace](https://docs.microsoft.com/azure/service-bus-messaging/service-bus-quickstart-portal).
The following sample assumes that you have setup an Azure Service Bus [namespace](https://learn.microsoft.com/azure/service-bus-messaging/service-bus-quickstart-portal).

* Update `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable
* Update `SERVICE_BUS_CONN_STR` environment variable
Expand All @@ -456,7 +456,7 @@ $ python sample_servicebus_receive.py

### Azure Storage Blob Create Container

The following sample assumes that you have setup Azure Blob [storage](https://docs.microsoft.com/azure/storage/blobs/storage-quickstart-blobs-portal).
The following sample assumes that you have setup Azure Blob [storage](https://learn.microsoft.com/azure/storage/blobs/storage-quickstart-blobs-portal).

* Update `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable
* Update `AZURE_STORAGE_CONNECTION_STRING` environment variable
Expand All @@ -475,7 +475,7 @@ $ python sample_storage_blob.py

### Azure Text Analytics Extract Key Phrases

The following sample assumes that you have setup an Azure Cognitive Services [Resource](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account).
The following sample assumes that you have setup an Azure Cognitive Services [Resource](https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account).

* Update `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable

Expand All @@ -493,6 +493,6 @@ $ python sample_text_analytics.py
## Explore the data

After running the applications, data would be available in [Azure](
https://docs.microsoft.com/azure/azure-monitor/app/app-insights-overview#where-do-i-see-my-telemetry)
https://learn.microsoft.com/azure/azure-monitor/app/app-insights-overview#where-do-i-see-my-telemetry)

<!-- cSpell:enable -->
14 changes: 7 additions & 7 deletions sdk/monitor/azure-monitor-query/migration_guide_app_insights.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

This guide assists you in the migration from [azure-applicationinsights](https://pypi.org/project/azure-applicationinsights/) v0.1.0 to [azure-monitor-query](https://pypi.org/project/azure-monitor-query/) v1.0.x. Side-by-side comparisons are provided for similar operations between the two packages.

Familiarity with the `azure-applicationinsights` v0.1.0 package is assumed. If you're new to the Azure Monitor Query client library for Python, see the [README for `azure-monitor-query`](https://docs.microsoft.com/python/api/overview/azure/monitor-query-readme?view=azure-python) instead of this guide.
Familiarity with the `azure-applicationinsights` v0.1.0 package is assumed. If you're new to the Azure Monitor Query client library for Python, see the [README for `azure-monitor-query`](https://learn.microsoft.com/python/api/overview/azure/monitor-query-readme?view=azure-python) instead of this guide.

## Table of contents

Expand All @@ -28,7 +28,7 @@ To improve the development experience across Azure services, a set of uniform [d

The Azure Monitor Query client library also takes advantage of the cross-service improvements made to the Azure development experience. Examples include:

- Using the new [Azure Identity](https://docs.microsoft.com/python/api/overview/azure/identity-readme?view=azure-python) library to share a single authentication approach between clients.
- Using the new [Azure Identity](https://learn.microsoft.com/python/api/overview/azure/identity-readme?view=azure-python) library to share a single authentication approach between clients.
- A unified logging and diagnostics pipeline offering a common view of the activities across each of the client libraries.

### New features
Expand All @@ -37,22 +37,22 @@ There are various new features in version 1.0 of the Monitor Query library. Some

- The ability to execute a batch of queries with the `LogsQueryClient.query_batch()` API.
- The ability to configure the retry policy used by the operations on the client.
- Authentication with Azure Active Directory (Azure AD) credentials using [azure-identity](https://docs.microsoft.com/python/api/overview/azure/identity-readme?view=azure-python).
- Authentication with Azure Active Directory (Azure AD) credentials using [azure-identity](https://learn.microsoft.com/python/api/overview/azure/identity-readme?view=azure-python).

For more new features, changes, and bug fixes, see the [change log](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/monitor/azure-monitor-query/CHANGELOG.md).

## Important changes

### Resource mode support

The Azure Monitor Query library doesn't support Application Insights resources using the [classic resource mode](https://docs.microsoft.com/azure/azure-monitor/app/create-new-resource). To use this library with a classic Application Insights resource, you must first [migrate to a workspace-based resource](https://docs.microsoft.com/azure/azure-monitor/app/convert-classic-resource).
The Azure Monitor Query library doesn't support Application Insights resources using the [classic resource mode](https://learn.microsoft.com/azure/azure-monitor/app/create-new-resource). To use this library with a classic Application Insights resource, you must first [migrate to a workspace-based resource](https://learn.microsoft.com/azure/azure-monitor/app/convert-classic-resource).

### The client

To provide a more intuitive experience, the top-level client to [ApplicationInsightsDataClient](https://docs.microsoft.com/python/api/azure-applicationinsights/azure.applicationinsights.applicationinsightsdataclient?view=azure-python) has been split into two different clients:
To provide a more intuitive experience, the top-level client to [ApplicationInsightsDataClient](https://learn.microsoft.com/python/api/azure-applicationinsights/azure.applicationinsights.applicationinsightsdataclient?view=azure-python) has been split into two different clients:

- [LogsQueryClient](https://docs.microsoft.com/python/api/azure-monitor-query/azure.monitor.query.logsqueryclient?view=azure-python) serves as a single point of entry to execute a single Kusto query or a batch of Kusto queries.
- [MetricsQueryClient](https://docs.microsoft.com/python/api/azure-monitor-query/azure.monitor.query.metricsqueryclient?view=azure-python) is used to query metrics, list metric namespaces, and to list metric definitions.
- [LogsQueryClient](https://learn.microsoft.com/python/api/azure-monitor-query/azure.monitor.query.logsqueryclient?view=azure-python) serves as a single point of entry to execute a single Kusto query or a batch of Kusto queries.
- [MetricsQueryClient](https://learn.microsoft.com/python/api/azure-monitor-query/azure.monitor.query.metricsqueryclient?view=azure-python) is used to query metrics, list metric namespaces, and to list metric definitions.

Both clients can be authenticated using Azure AD.

Expand Down

0 comments on commit 7385768

Please sign in to comment.