Skip to content

Commit 6c2de0a

Browse files
authored
Merge pull request #230718 from v-jbasden/v-jbasden-create-data-model-complete
Adding app/data-model-complete.md
2 parents 2ecb8bb + 64e99f9 commit 6c2de0a

24 files changed

+507
-567
lines changed

.openpublishing.redirection.azure-monitor.json

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6045,6 +6045,52 @@
60456045
"source_path_from_root": "/articles/azure-monitor/app/status-monitor-v2-api-reference.md",
60466046
"redirect_url": "/azure/azure-monitor/app/application-insights-asp-net-agent",
60476047
"redirect_document_id": false
6048+
},
6049+
{
6050+
"source_path_from_root": "/articles/azure-monitor/app/data-model.md",
6051+
"redirect_url": "/azure/azure-monitor/app/data-model-complete",
6052+
"redirect_document_id": false
6053+
},
6054+
{
6055+
"source_path_from_root": "/articles/azure-monitor/app/data-model-request-telemetry.md",
6056+
"redirect_url": "/azure/azure-monitor/app/data-model-complete",
6057+
"redirect_document_id": false
6058+
},
6059+
{
6060+
"source_path_from_root": "/articles/azure-monitor/app/data-model-dependency-telemetry.md",
6061+
"redirect_url": "/azure/azure-monitor/app/data-model-complete",
6062+
"redirect_document_id": false
6063+
},
6064+
{
6065+
"source_path_from_root": "/articles/azure-monitor/app/data-model-exception-telemetry.md",
6066+
"redirect_url": "/azure/azure-monitor/app/data-model-complete",
6067+
"redirect_document_id": false
6068+
},
6069+
{
6070+
"source_path_from_root": "/articles/azure-monitor/app/data-model-trace-telemetry.md",
6071+
"redirect_url": "/azure/azure-monitor/app/data-model-complete",
6072+
"redirect_document_id": false
6073+
},
6074+
{
6075+
"source_path_from_root": "/articles/azure-monitor/app/data-model-event-telemetry.md",
6076+
"redirect_url": "/azure/azure-monitor/app/data-model-complete",
6077+
"redirect_document_id": false
6078+
},
6079+
{
6080+
"source_path_from_root": "/articles/azure-monitor/app/data-model-metric-telemetry.md",
6081+
"redirect_url": "/azure/azure-monitor/app/data-model-complete",
6082+
"redirect_document_id": false
6083+
},
6084+
{
6085+
"source_path_from_root": "/articles/azure-monitor/app/data-model-pageview-telemetry.md",
6086+
"redirect_url": "/azure/azure-monitor/app/data-model-complete",
6087+
"redirect_document_id": false
6088+
},
6089+
{
6090+
"source_path_from_root": "/articles/azure-monitor/app/data-model-context.md",
6091+
"redirect_url": "/azure/azure-monitor/app/data-model-complete",
6092+
"redirect_document_id": false
60486093
}
6094+
60496095
]
60506096
}

articles/api-management/trace-policy.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ ms.author: danlep
1414
The `trace` policy adds a custom trace into the request tracing output in the test console, Application Insights telemetries, and/or resource logs.
1515

1616
- The policy adds a custom trace to the [request tracing](./api-management-howto-api-inspector.md) output in the test console when tracing is triggered, that is, `Ocp-Apim-Trace` request header is present and set to `true` and `Ocp-Apim-Subscription-Key` request header is present and holds a valid key that allows tracing.
17-
- The policy creates a [Trace](../azure-monitor/app/data-model-trace-telemetry.md) telemetry in Application Insights, when [Application Insights integration](./api-management-howto-app-insights.md) is enabled and the `severity` specified in the policy is equal to or greater than the `verbosity` specified in the diagnostic setting.
17+
- The policy creates a [Trace](../azure-monitor/app/data-model-complete.md#trace) telemetry in Application Insights, when [Application Insights integration](./api-management-howto-app-insights.md) is enabled and the `severity` specified in the policy is equal to or greater than the `verbosity` specified in the diagnostic setting.
1818
- The policy adds a property in the log entry when [resource logs](./api-management-howto-use-azure-monitor.md#resource-logs) are enabled and the severity level specified in the policy is at or higher than the verbosity level specified in the diagnostic setting.
1919
- The policy is not affected by Application Insights sampling. All invocations of the policy will be logged.
2020

@@ -43,7 +43,7 @@ The `trace` policy adds a custom trace into the request tracing output in the te
4343
|Name|Description|Required|
4444
|----------|-----------------|--------------|
4545
| message | A string or expression to be logged. | Yes |
46-
| metadata | Adds a custom property to the Application Insights [Trace](../azure-monitor/app/data-model-trace-telemetry.md) telemetry. | No |
46+
| metadata | Adds a custom property to the Application Insights [Trace](../azure-monitor/app/data-model-complete.md#trace) telemetry. | No |
4747

4848
### metadata attributes
4949

articles/azure-monitor/app/app-insights-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Application Insights is an extension of [Azure Monitor](../overview.md) and prov
1212
1. *Proactively* understand how an application is performing.
1313
1. *Reactively* review application execution data to determine the cause of an incident.
1414

15-
In addition to collecting [Metrics](standard-metrics.md) and application [Telemetry](data-model.md) data, which describe application activities and health, Application Insights can also be used to collect and store application [trace logging data](asp-net-trace-logs.md).
15+
In addition to collecting [Metrics](standard-metrics.md) and application [Telemetry](data-model-complete.md) data, which describe application activities and health, Application Insights can also be used to collect and store application [trace logging data](asp-net-trace-logs.md).
1616

1717
The [log trace](asp-net-trace-logs.md) is associated with other telemetry to give a detailed view of the activity. Adding trace logging to existing apps only requires providing a destination for the logs; the logging framework rarely needs to be changed.
1818

articles/azure-monitor/app/asp-net-dependencies.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -204,7 +204,7 @@ This section provides answers to common questions.
204204
205205
### How does the automatic dependency collector report failed calls to dependencies?
206206
207-
Failed dependency calls will have the `success` field set to False. The module `DependencyTrackingTelemetryModule` doesn't report `ExceptionTelemetry`. The full data model for dependency is described [Dependency telemetry: Application Insights data model](data-model-dependency-telemetry.md).
207+
Failed dependency calls will have the `success` field set to False. The module `DependencyTrackingTelemetryModule` doesn't report `ExceptionTelemetry`. The full data model for dependency is described in [Application Insights telemetry data model](data-model-complete.md#dependency).
208208
209209
### How do I calculate ingestion latency for my dependency telemetry?
210210
@@ -276,5 +276,5 @@ A list of the latest [currently supported modules](https://github.com/microsoft/
276276
* Set up custom dependency tracking for [Java](opentelemetry-enable.md?tabs=java#add-custom-spans).
277277
* Set up custom dependency tracking for [OpenCensus Python](./opencensus-python-dependency.md).
278278
* [Write custom dependency telemetry](./api-custom-events-metrics.md#trackdependency)
279-
* See [data model](./data-model.md) for Application Insights types and data model.
279+
* See [data model](./data-model-complete.md) for Application Insights types and data model.
280280
* Check out [platforms](./app-insights-overview.md#supported-languages) supported by Application Insights.

articles/azure-monitor/app/codeless-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.reviewer: abinetabate
88

99
# What is auto-instrumentation for Azure Monitor Application Insights?
1010

11-
Auto-instrumentation quickly and easily enables [Application Insights](app-insights-overview.md) to make [telemetry](data-model.md) like metrics, requests, and dependencies available in your [Application Insights resource](create-workspace-resource.md).
11+
Auto-instrumentation quickly and easily enables [Application Insights](app-insights-overview.md) to make [telemetry](data-model-complete.md) like metrics, requests, and dependencies available in your [Application Insights resource](create-workspace-resource.md).
1212

1313
> [!div class="checklist"]
1414
> - No code changes are required.

articles/azure-monitor/app/correlation.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -18,11 +18,11 @@ This article explains the data model used by Application Insights to correlate t
1818

1919
## Data model for telemetry correlation
2020

21-
Application Insights defines a [data model](../../azure-monitor/app/data-model.md) for distributed telemetry correlation. To associate telemetry with a logical operation, every telemetry item has a context field called `operation_Id`. This identifier is shared by every telemetry item in the distributed trace. So even if you lose telemetry from a single layer, you can still associate telemetry reported by other components.
21+
Application Insights defines a [data model](../../azure-monitor/app/data-model-complete.md) for distributed telemetry correlation. To associate telemetry with a logical operation, every telemetry item has a context field called `operation_Id`. This identifier is shared by every telemetry item in the distributed trace. So even if you lose telemetry from a single layer, you can still associate telemetry reported by other components.
2222

23-
A distributed logical operation typically consists of a set of smaller operations that are requests processed by one of the components. These operations are defined by [request telemetry](../../azure-monitor/app/data-model-request-telemetry.md). Every request telemetry item has its own `id` that identifies it uniquely and globally. And all telemetry items (such as traces and exceptions) that are associated with the request should set the `operation_parentId` to the value of the request `id`.
23+
A distributed logical operation typically consists of a set of smaller operations that are requests processed by one of the components. These operations are defined by [request telemetry](../../azure-monitor/app/data-model-complete.md#request). Every request telemetry item has its own `id` that identifies it uniquely and globally. And all telemetry items (such as traces and exceptions) that are associated with the request should set the `operation_parentId` to the value of the request `id`.
2424

25-
Every outgoing operation, such as an HTTP call to another component, is represented by [dependency telemetry](../../azure-monitor/app/data-model-dependency-telemetry.md). Dependency telemetry also defines its own `id` that's globally unique. Request telemetry, initiated by this dependency call, uses this `id` as its `operation_parentId`.
25+
Every outgoing operation, such as an HTTP call to another component, is represented by [dependency telemetry](../../azure-monitor/app/data-model-complete.md#dependency). Dependency telemetry also defines its own `id` that's globally unique. Request telemetry, initiated by this dependency call, uses this `id` as its `operation_parentId`.
2626

2727
You can build a view of the distributed logical operation by using `operation_Id`, `operation_parentId`, and `request.id` with `dependency.id`. These fields also define the causality order of telemetry calls.
2828

@@ -79,7 +79,7 @@ The [W3C Trace-Context](https://w3c.github.io/trace-context/) and Application In
7979
| `Operation_Id` | [trace-id](https://w3c.github.io/trace-context/#trace-id) |
8080
| `Operation_ParentId` | [parent-id](https://w3c.github.io/trace-context/#parent-id) of this span's parent span. This field must be empty if it's a root span.|
8181

82-
For more information, see [Application Insights telemetry data model](../../azure-monitor/app/data-model.md).
82+
For more information, see [Application Insights telemetry data model](../../azure-monitor/app/data-model-complete.md).
8383

8484
### Enable W3C distributed tracing support for .NET apps
8585

@@ -383,6 +383,6 @@ You can also set the cloud role name via environment variable or system property
383383
- For advanced correlation scenarios in ASP.NET Core and ASP.NET, see [Track custom operations](custom-operations-tracking.md).
384384
- Learn more about [setting cloud_RoleName](./app-map.md#set-or-override-cloud-role-name) for other SDKs.
385385
- Onboard all components of your microservice on Application Insights. Check out the [supported platforms](./app-insights-overview.md#supported-languages).
386-
- See the [data model](./data-model.md) for Application Insights types.
386+
- See the [data model](./data-model-complete.md) for Application Insights types.
387387
- Learn how to [extend and filter telemetry](./api-filtering-sampling.md).
388388
- Review the [Application Insights config reference](configuration-with-applicationinsights-config.md).

articles/azure-monitor/app/custom-operations-tracking.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -415,7 +415,7 @@ Each Application Insights operation (request or dependency) involves `Activity`.
415415

416416
- Learn the basics of [telemetry correlation](correlation.md) in Application Insights.
417417
- Check out how correlated data powers [transaction diagnostics experience](./transaction-diagnostics.md) and [Application Map](./app-map.md).
418-
- See the [data model](./data-model.md) for Application Insights types and data model.
418+
- See the [data model](./data-model-complete.md) for Application Insights types and data model.
419419
- Report custom [events and metrics](./api-custom-events-metrics.md) to Application Insights.
420420
- Check out standard [configuration](configuration-with-applicationinsights-config.md#telemetry-initializers-aspnet) for context properties collection.
421421
- Check the [System.Diagnostics.Activity User Guide](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Diagnostics.DiagnosticSource/src/ActivityUserGuide.md) to see how we correlate telemetry.

0 commit comments

Comments
 (0)