Merge pull request #216127 from olmoloce/patch-1

Create concepts-annotations-userproperties.md

Author: ShannonLeavitt

articles/data-factory/TOC.yml

@@ -193,7 +193,9 @@ items:
     href: concepts-pipelines-activities.md
     displayName: retry, timeout
   - name: Pipeline parameters and variables
-    href: concepts-parameters-variables.md 
+    href: concepts-parameters-variables.md
+  - name: Annotations and user properties
+    href: concepts-annotations-user-properties.md 
   - name: Nested activities
     href: concepts-nested-activities.md
     displayName: nested, nesting

articles/data-factory/concepts-annotations-user-properties.md

@@ -0,0 +1,56 @@
+---
+title: Monitor Azure Data Factory and Azure Synapse Analytics pipelines with annotations and user properties
+description: Advanced monitoring with annotations and user properties
+author: olmoloce
+ms.author: olmoloce
+ms.reviewer: olmoloce
+ms.service: data-factory
+ms.subservice: monitoring
+ms.topic: conceptual
+ms.date: 11/01/2022
+---
+
+# Monitor Azure Data Factory and Azure Synapse Analytics pipelines with annotations and user properties
+
+[!INCLUDE[appliesto-adf-asa-md](includes/appliesto-adf-asa-md.md)]
+
+When monitoring your data pipelines, you may want to be able to filter and monitor a certain group of activities, such as those of a project or specific department's pipelines. You may also need to further monitor activities based on dynamic properties. You can achieve these things by leveraging annotations and user properties.
+
+## Annotations
+
+Azure Data Factory annotations are tags that you can add to your Azure Data Factory or Azure Synapse Analytics entities to easily identify them. An annotation allows you to classify or group different entities in order to easily monitor or filter them after an execution. Annotations only allow you to define static values and can be added to pipelines, datasets, linked services and triggers.
+
+## User properties
+
+User properties are key-value pairs defined at the activity level. By adding user properties, you can view additional information about activities under activity runs window that may help you to monitor your activity executions.
+User properties allow you to define dynamic values and can be added to any activity, up to 5 per activity, under User Properties tab.
+
+## Create and use annotations and user properties
+
+As we discussed, annotations are static values that you can assign to pipelines, datasets, linked services, and triggers. Let's assume you want to filter for pipelines that belong to the same business unit or project name. We will first create the annotation. Click on the Properties icon, + New button and name your annotation appropriately. We advise being consistent with your naming.
+
+![Screenshot showing how to create an annotation.](./media/concepts-annotations-user-properties/create-annotations.png "Create Annotation")
+
+When you go to the Monitor tab, you can filter under Pipeline runs for this Annotation:
+
+![Screenshot showing how to monitor an annotations.](./media/concepts-annotations-user-properties/monitor-annotations.png "Monitor Annotations")
+
+If you want to monitor for dynamic values at the activity level, you can do so by leveraging the User properties. You can add these under any activity by clicking on the Activity box, User properties tab and the + New button:
+
+![Screenshot showing how to create user properties.](./media/concepts-annotations-user-properties/create-user-properties.png "Create User Properties")
+
+For Copy Activity specifically, you can auto-generate these:
+
+![Screenshot showing User Properties under Copy activity.](./media/concepts-annotations-user-properties/copy-activity-user-properties.png "Copy Activity User Properties")
+
+To monitor User properties, go to the Activity runs monitoring view. Here you will see all the properties you added.
+
+![Screenshot showing how to use User Properties in the Monitor tab.](./media/concepts-annotations-user-properties/monitor-user-properties.png "Monitor User Properties")
+
+You can remove some from the view if you click on the Bookmark sign:
+
+![Screenshot showing how to remove User Properties.](./media/concepts-annotations-user-properties/remove-user-properties.png "Remove User Properties")
+
+## Next steps
+
+To learn more about monitoring see [Visually monitor Azure Data Factory.](./monitor-visually.md)