Skip to content

Commit 428e680

Browse files
subatoiam-stead
andauthored
Actions: Fix some versioning related to audit logs for organizations (#54837)
Co-authored-by: Anne-Marie <[email protected]>
1 parent c27db32 commit 428e680

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

content/actions/sharing-automations/reusing-workflows.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -417,6 +417,12 @@ For more information on using job outputs, see [AUTOTITLE](/actions/using-workfl
417417

418418
## Monitoring which workflows are being used
419419

420+
{% ifversion fpt or ghes %}
421+
422+
Organizations that use {% data variables.product.prodname_ghe_cloud %} can interact with the audit log via the {% data variables.product.github %} REST API to monitor which workflows are being used. For more information, see [the {% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization#using-the-audit-log-api).
423+
424+
{% else %}
425+
420426
You can use the {% data variables.product.prodname_dotcom %} REST API to monitor how reusable workflows are being used. The `prepared_workflow_job` audit log action is triggered when a workflow job is started. Included in the data recorded are:
421427
* `repo` - the organization/repository where the workflow job is located. For a job that calls another workflow, this is the organization/repository of the caller workflow.
422428
* `@timestamp` - the date and time that the job was started, in Unix epoch format.
@@ -425,11 +431,13 @@ You can use the {% data variables.product.prodname_dotcom %} REST API to monitor
425431
* `calling_workflow_shas` - an array of SHAs for all the caller workflows involved in this workflow job. The array contains the same number of items, in the same order, as the `calling_workflow_refs` array.
426432
* `job_workflow_ref` - the workflow file that was used, in the form `{owner}/{repo}/{path}/{filename}@{ref}`. For a job that calls another workflow, this identifies the called workflow.
427433

428-
For information about using the REST API to query the audit log for an organization, see [AUTOTITLE](/rest/orgs#get-the-audit-log-for-an-organization).
434+
For more information, see [AUTOTITLE](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization#using-the-audit-log-api).
429435

430436
> [!NOTE]
431437
> Audit data for `prepared_workflow_job` can only be viewed using the REST API. It is not visible in the {% data variables.product.prodname_dotcom %} web interface, or included in JSON/CSV exported audit data.
432438

439+
{% endif %}
440+
433441
## Re-running workflows and jobs with reusable workflows
434442

435443
{% data reusables.actions.partial-reruns-with-reusable %}

0 commit comments

Comments
 (0)