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
intro: 'Learn how to access and interpret expression evaluation logs for job-level `if` conditions in {% data variables.product.prodname_actions %}.'
5
+
versions:
6
+
fpt: '*'
7
+
ghec: '*'
8
+
contentType: how-tos
9
+
---
10
+
11
+
When a job's `if` condition is evaluated, {% data variables.product.prodname_actions %} logs the expression evaluation to help you understand the result. This is useful for debugging both why a job was skipped and why a job ran when you expected it to be skipped.
|**Evaluating**| The original `if` expression from your workflow file. |
34
+
|**Expanded**| The expression with context values substituted. This shows you exactly what values were used at runtime. |
35
+
|**Result**| The final evaluation result (`true` or `false`). |
36
+
37
+
In this example, the expanded line reveals that `github.repository` was `'my-username/octo-repo-prod'` (not `'octo-org/octo-repo-prod'`), which caused the condition to evaluate to `false`.
38
+
39
+
> [!NOTE]
40
+
> Expression logs are only available for job-level `if` conditions. For step-level conditions, you can enable debug logging to see expression evaluation in the job logs. For more information, see [AUTOTITLE](/actions/how-tos/monitor-workflows/enable-debug-logging).
Copy file name to clipboardExpand all lines: content/actions/how-tos/troubleshoot-workflows.md
+17Lines changed: 17 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -98,6 +98,23 @@ For path filtering, evaluating diffs is limited to the first 300 files. If there
98
98
99
99
Workflow execution involves any issues seen after the workflow was triggered and a workflow run has been created.
100
100
101
+
{% ifversion fpt or ghec %}
102
+
103
+
### Debugging job conditions
104
+
105
+
If a job was skipped unexpectedly, or ran when you expected it to be skipped, you can view the expression evaluation to understand why:
106
+
107
+
1. Click on the job in the workflow run.
108
+
1. Download the log archive from the job's menu.
109
+
1. Open the `JOB-NAME/system.txt` file.
110
+
1. Look for the `Evaluating`, `Expanded`, and `Result` lines.
111
+
112
+
The `Expanded` line shows the actual runtime values that were substituted into your `if` condition, making it clear why the expression evaluated to `true` or `false`.
113
+
114
+
For more information, see [AUTOTITLE](/actions/how-tos/monitor-workflows/view-job-condition-logs).
115
+
116
+
{% endif %}
117
+
101
118
### Canceling Workflows
102
119
103
120
If standard cancellation through the [UI](/actions/managing-workflow-runs-and-deployments/managing-workflow-runs/canceling-a-workflow) or [API](/rest/actions/workflow-runs?apiVersion=2022-11-28#cancel-a-workflow-run) does not process as expected, there may be a conditional statement configured for your running workflow job(s) that causes it to not cancel.
Copy file name to clipboardExpand all lines: content/actions/how-tos/write-workflows/choose-when-workflows-run/control-jobs-with-conditions.md
+6Lines changed: 6 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,3 +37,9 @@ Skipped jobs display the message "This check was skipped."
37
37
38
38
> [!NOTE]
39
39
> A job that is skipped will report its status as "Success". It will not prevent a pull request from merging, even if it is a required check.
40
+
41
+
{% ifversion fpt or ghec %}
42
+
43
+
To debug why a job was skipped or ran unexpectedly, you can view job condition expression logs. For more information, see [AUTOTITLE](/actions/how-tos/monitor-workflows/view-job-condition-logs).
Copy file name to clipboardExpand all lines: content/admin/data-residency/feature-overview-for-github-enterprise-cloud-with-data-residency.md
+15-7Lines changed: 15 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,19 +16,27 @@ redirect_from:
16
16
17
17
## Currently unavailable features
18
18
19
-
The following features are currently unavailable on {% data variables.enterprise.data_residency_site %}.
19
+
The following features are currently unavailable on {% data variables.enterprise.data_residency_site %}, but may be planned for future development.
20
20
21
21
| Feature | Details | More information |
22
22
| :- | :- | :- |
23
-
| {% data variables.product.prodname_copilot_short %} Metrics API | Currently unavailable |[AUTOTITLE](/rest/copilot/copilot-metrics)|
23
+
| {% data variables.product.prodname_copilot_short %} Metrics API | Currently unavailable.|[AUTOTITLE](/rest/copilot/copilot-metrics)|
24
24
| {% data variables.product.prodname_github_codespaces %} | Currently unavailable. |[AUTOTITLE](/codespaces/quickstart)|
25
-
| {% data variables.product.prodname_importer %} (the "Import repository" button on {% data variables.product.prodname_dotcom_the_website %}) | Instead, the **{% data variables.product.prodname_importer_proper_name %}** is available to migrate data. See [AUTOTITLE](/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer). |[AUTOTITLE](/migrations/importing-source-code/using-github-importer/about-github-importer)|
26
-
| {% data variables.product.prodname_marketplace %} | Currently, apps from {% data variables.product.prodname_marketplace %} are unavailable. {% data variables.product.prodname_actions %} workflows from {% data variables.product.prodname_marketplace %} may not function as expected. For more information, see [{% data variables.product.prodname_actions %} workflows from {% data variables.product.prodname_marketplace %}](#github-actions-workflows-from-github-marketplace). |[AUTOTITLE](/search-github/searching-on-github/searching-github-marketplace)<br>[AUTOTITLE](/enterprise-server@latest/admin/configuration/configuring-github-connect/about-github-connect#github-connect-features) in the {% data variables.product.prodname_ghe_server %} documentation |
27
-
| {% data variables.product.prodname_github_models %} | Currently unavailable |[AUTOTITLE](/github-models/about-github-models)|
28
25
| macOS runners for {% data variables.product.prodname_actions %} | Currently unavailable. |[AUTOTITLE](/actions/using-github-hosted-runners/about-github-hosted-runners/about-github-hosted-runners)|
29
26
| Maven and Gradle support for {% data variables.product.prodname_registry %} | Currently unavailable. |[AUTOTITLE](/packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry)|
30
-
| {% data variables.product.prodname_spark_short %} | Unavailable due to dependency on {% data variables.product.prodname_github_codespaces %} |[AUTOTITLE](/copilot/concepts/spark)|
31
-
| Some features currently in {% data variables.release-phases.public_preview %} or {% data variables.release-phases.private_preview %} | Certain features that are in a preview phase on {% data variables.product.prodname_dotcom_the_website %} may not be available on {% data variables.enterprise.data_residency_site %} ||
27
+
| {% data variables.product.prodname_spark_short %} | Currently unavailable. |[AUTOTITLE](/copilot/concepts/spark)|
28
+
| {% data variables.product.prodname_marketplace %} | {% data variables.product.prodname_marketplace %}, as a means of searching for, purchasing, and directly installing apps and actions, is unavailable. Ecosystem apps and actions can still be discovered and installed from their source, but they may require modification to work on {% data variables.enterprise.data_residency_site %}. |[{% data variables.product.prodname_actions %} workflows from {% data variables.product.prodname_marketplace %}](#github-actions-workflows-from-github-marketplace)|
29
+
| Certain features of {% data variables.product.prodname_github_connect %} | Although you can connect an enterprise on {% data variables.enterprise.data_residency_site %} to a {% data variables.product.prodname_ghe_server %} instance, certain features of {% data variables.product.prodname_github_connect %} are not available, including resolution of actions from {% data variables.product.prodname_dotcom_the_website %}. |[{% data variables.product.prodname_github_connect %}](#github-connect)|
30
+
| Some features currently in {% data variables.release-phases.public_preview %} or {% data variables.release-phases.private_preview %} | Certain features that are in a preview phase on {% data variables.product.prodname_dotcom_the_website %} may not be available on {% data variables.enterprise.data_residency_site %} until GA. ||
31
+
32
+
## Permanently unavailable features
33
+
34
+
By design, the following features are permanently unavailable on {% data variables.enterprise.data_residency_site %}. This is generally because they are not intended for large enterprises with strict compliance requirements.
35
+
36
+
| Feature | Details | More information |
37
+
| :- | :- | :- |
38
+
| Features unavailable with {% data variables.product.prodname_emus %} | Because {% data variables.product.prodname_emus %} is the only option for identity management on {% data variables.enterprise.data_residency_site %}, features that are unavailable with {% data variables.product.prodname_emus %} on {% data variables.product.prodname_dotcom_the_website %} are also unavailable on {% data variables.enterprise.data_residency_site %}. Notably, these include gists and public repositories. |[AUTOTITLE](/admin/managing-iam/understanding-iam-for-enterprises/abilities-and-restrictions-of-managed-user-accounts)|
39
+
| {% data variables.product.prodname_importer %} (the "Import repository" button on {% data variables.product.prodname_dotcom_the_website %}) | Instead, the **{% data variables.product.prodname_importer_proper_name %}** is available to migrate data. See [AUTOTITLE](/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer). |[AUTOTITLE](/migrations/importing-source-code/using-github-importer/about-github-importer)|
0 commit comments