title | description | author | ms.author | ms.reviewer | ms.subservice | ms.topic | ms.date |
---|---|---|---|---|---|---|---|
Visually monitor Azure Data Factory |
Learn how to visually monitor Azure data factories |
nabhishek |
abnarain |
jburchel |
monitoring |
conceptual |
01/05/2024 |
[!INCLUDEappliesto-adf-xxx-md]
Once you've created and published a pipeline in Azure Data Factory, you can associate it with a trigger or manually kick off an ad hoc run. You can monitor all of your pipeline runs natively in the Azure Data Factory user experience. To open the monitoring experience, select the Monitor & Manage tile in the data factory blade of the Azure portal. If you're already in the ADF UX, click on the Monitor icon on the left sidebar.
By default, all data factory runs are displayed in the browser's local time zone. If you change the time zone, all the date/time fields snap to the one that you selected.
The default monitoring view is list of triggered pipeline runs in the selected time period. You can change the time range and filter by status, pipeline name, or annotation. Hover over the specific pipeline run to get run-specific actions such as rerun and the consumption report.
:::image type="content" source="media/monitor-visually/pipeline-runs.png" alt-text="Screenshot of list view for monitoring pipeline runs.":::
The pipeline run grid contains the following columns:
Column name | Description |
---|---|
Pipeline Name | Name of the pipeline |
Run Start | Start date and time for the pipeline run (MM/DD/YYYY, HH:MM:SS AM/PM) |
Run End | End date and time for the pipeline run (MM/DD/YYYY, HH:MM:SS AM/PM) |
Duration | Run duration (HH:MM:SS) |
Triggered By | The name of the trigger that started the pipeline |
Status | Failed, Succeeded, In Progress, Canceled, or Queued |
Annotations | Filterable tags associated with a pipeline |
Parameters | Parameters for the pipeline run (name/value pairs) |
Error | If the pipeline failed, the run error |
Run | Original, Rerun, or Rerun (Latest) |
Run ID | ID of the pipeline run |
You need to manually select the Refresh button to refresh the list of pipeline and activity runs. Autorefresh is currently not supported.
:::image type="content" source="media/monitor-visually/refresh.png" alt-text=" Screenshot of refresh button.":::
To view the results of a debug run, select the Debug tab.
:::image type="content" source="media/iterative-development-debugging/view-debug-runs.png" alt-text="Screenshot of the view active debug runs icon.":::
To get a detailed view of the individual activity runs of a specific pipeline run, click on the pipeline name.
:::image type="content" source="media/monitor-visually/view-activity-runs.png" alt-text="Screenshot of view activity runs.":::
The list view shows activity runs that correspond to each pipeline run. Hover over the specific activity run to get run-specific information such as the JSON input, JSON output, and detailed activity-specific monitoring experiences.
:::image type="content" source="media/monitor-visually/activity-runs.png" alt-text="Screenshot of information about SalesAnalyticsMLPipeline, followed by a list of activity runs.":::
Column name | Description |
---|---|
Activity Name | Name of the activity inside the pipeline |
Activity Type | Type of the activity, such as Copy, ExecuteDataFlow, or AzureMLExecutePipeline |
Actions | Icons that allow you to see JSON input information, JSON output information, or detailed activity-specific monitoring experiences |
Run Start | Start date and time for the activity run (MM/DD/YYYY, HH:MM:SS AM/PM) |
Duration | Run duration (HH:MM:SS) |
Status | Failed, Succeeded, In Progress, or Canceled |
Integration Runtime | Which Integration Runtime the activity was run on |
User Properties | User-defined properties of the activity |
Error | If the activity failed, the run error |
Run ID | ID of the activity run |
If an activity failed, you can see the detailed error message by clicking on the icon in the error column.
:::image type="content" source="media/monitor-visually/activity-run-error.png" alt-text="Screenshot of a notification with error details including error code, failure type, and error details.":::
Promote any pipeline activity property as a user property so that it becomes an entity that you monitor. For example, you can promote the Source and Destination properties of the copy activity in your pipeline as user properties.
Note
You can only promote up to five pipeline activity properties as user properties.
:::image type="content" source="media/monitor-visually/promote-user-properties.png" alt-text="Screenshot of create user properties.":::
After you create the user properties, you can monitor them in the monitoring list views.
:::image type="content" source="media/monitor-visually/choose-user-properties.png" alt-text="Screenshot of add columns for user properties to the activity runs list.":::
If the source for the copy activity is a table name, you can monitor the source table name as a column in the list view for activity runs.
:::image type="content" source="media/monitor-visually/view-user-properties.png" alt-text="Screenshot of activity runs list with columns for user properties.":::
Rerun behavior of the container activities is as follows:
Wait
- Activity will behave as before.Set Variable
- Activity will behave as before.Filter
- Activity will behave as before.Until
Activity will evaluate the expression and will loop until the condition is satisfied. Inner activities may still be skipped based on the rerun rules.Foreach
Activity will always loop on the items it receives. Inner activities may still be skipped based on the rerun rules.If and switch
- Conditions will always be evaluated. All inner activities will be evaluated. Inner activities may still be skipped based on the rerun rules, but acities such as Execute Pipeline will rerun.Execute pipeline activity
- The child pipeline will be triggered, but all activities in the child pipeline may still be skipped based on the rerun rules.
To rerun a pipeline that has previously ran from the start, hover over the specific pipeline run and select Rerun. If you select multiple pipelines, you can use the Rerun button to run them all.
:::image type="content" source="media/monitor-visually/rerun-pipeline.png" alt-text="Screenshot of rerun a pipeline.":::
If you wish to rerun starting at a specific point, you can do so from the activity runs view. Select the activity you wish to start from and select Rerun from activity.
:::image type="content" source="media/monitor-visually/rerun-activity.png" alt-text="Screenshot of rerun an activity run.":::
You can also rerun a pipeline and change the parameters. Select the New parameters button to change the parameters.
:::image type="content" source="media/monitor-visually/monitor-rerun-new-parameters.png" alt-text="Screenshot of rerun an activity run with new parameters.":::
Note
Rerunning a pipeline with new parameters will be considered a new pipeline run so will not show under the rerun groupings for a pipeline run.
If an activity fails, times out, or is canceled, you can rerun the pipeline from that failed activity by selecting Rerun from failed activity.
:::image type="content" source="media/monitor-visually/rerun-failed-activity.png" alt-text="Screenshot of rerun failed activity.":::
You can view the rerun history for all the pipeline runs in the list view.
:::image type="content" source="media/monitor-visually/rerun-history-1.png" alt-text="Screenshot of view history.":::
You can also view rerun history for a particular pipeline run.
:::image type="content" source="media/monitor-visually/view-rerun-history.png" alt-text="Screenshot of view history for a pipeline run.":::
You can see the resources consumed by a pipeline run by clicking the consumption icon next to the run.
:::image type="content" source="media/monitor-visually/monitor-consumption-1.png" alt-text="Screenshot that shows where you can see the resources consumed by a pipeline.":::
Clicking the icon opens a consumption report of resources used by that pipeline run.
:::image type="content" source="media/monitor-visually/monitor-consumption-2.png" alt-text="Screenshot of monitor consumption.":::
You can plug these values into the Azure pricing calculator to estimate the cost of the pipeline run. For more information on Azure Data Factory pricing, see Understanding pricing.
Note
These values returned by the pricing calculator is an estimate. It doesn't reflect the exact amount you will be billed by Azure Data Factory
A Gantt chart is a view that allows you to see the run history over a time range. By switching to a Gantt view, you will see all pipeline runs grouped by name displayed as bars relative to how long the run took. You can also group by annotations/tags that you've create on your pipeline. The Gantt view is also available at the activity run level.
:::image type="content" source="media/monitor-visually/select-gantt.png" alt-text="Screenshot of an example of a Gantt chart.":::
The length of the bar informs the duration of the pipeline. You can also select the bar to see more details.
:::image type="content" source="media/monitor-visually/view-gantt-run.png" alt-text="Screenshot of a Gantt chart duration.":::
You can raise alerts on supported metrics in Data Factory. Select Monitor > Alerts & metrics on the Data Factory monitoring page to get started.
:::image type="content" source="media/monitor-visually/start-page.png" alt-text="Screenshot of the Data factory Monitor page.":::
For a seven-minute introduction and demonstration of this feature, watch the following video:
-
Select New alert rule to create a new alert.
:::image type="content" source="media/monitor-visually/new-alerts.png" alt-text="Screenshot of New Alert Rule button.":::
-
Specify the rule name and select the alert severity.
:::image type="content" source="media/monitor-visually/name-and-severity.png" alt-text="Screenshot of boxes for rule name and severity.":::
-
Select the alert criteria.
:::image type="content" source="media/monitor-visually/add-criteria-1.png" alt-text="Screenshot of box for target criteria.":::
:::image type="content" source="media/monitor-visually/add-criteria-2.png" alt-text="Screenshot that shows where you select one metric to set up the alert condition.":::
:::image type="content" source="media/monitor-visually/add-criteria-3.png" alt-text="Screenshot of list of criteria.":::
You can create alerts on various metrics, including those for ADF entity count/size, activity/pipeline/trigger runs, Integration Runtime (IR) CPU utilization/memory/node count/queue, as well as for SSIS package executions and SSIS IR start/stop operations.
-
Configure the alert logic. You can create an alert for the selected metric for all pipelines and corresponding activities. You can also select a particular activity type, activity name, pipeline name, or failure type.
:::image type="content" source="media/monitor-visually/alert-logic.png" alt-text="Screenshot of options for configuring alert logic.":::
-
Configure email, SMS, push, and voice notifications for the alert. Create an action group, or choose an existing one, for the alert notifications.
:::image type="content" source="media/monitor-visually/configure-notification-1.png" alt-text="Screenshot of options for configuring notifications.":::
:::image type="content" source="media/monitor-visually/configure-notification-2.png" alt-text="Screenshot of options for adding a notification.":::
-
Create the alert rule.
:::image type="content" source="media/monitor-visually/create-alert-rule.png" alt-text="Screenshot of options for creating an alert rule.":::
To learn about monitoring and managing pipelines, see the Monitor and manage pipelines programmatically article.