Table of Table of contents

...

Historical Actions in the Logs

For all the actions it is possible to see the log starting from the installation of the plugin. However, for the issue- and asset-related actions, also historical data, starting from January 1st, 2022 will be also available in the app. With the first install, you will see the corresponding informational message:

...

After the first install, depending on the number of issues and Asset objects, retrieving historical data may take from minutes to hours.

The actions on the following components are not available in the historical data and only the actions done after the app installation will be visible:

• Global feature enable/disable

• Board

• Sprint

• Version

• Users

• Project category

• Comment update old value

• Issue deleted

• Actions from Jira administration audit log

• Jira organization audit log

• Assets audit log

• Issue view

If you need to log additional actions, configure permissions, and add fields for monitoring, please visit Settings. From here you can configure connections to retrieve actions from:

• Organizations audit log

• Administration audit log

• Assets audit log

Basic Search

Using the basic search, you can define several terms from your Jira instance for filtering the users for which you would like to see the results in the audit log. There are the following options:

1. Calendar

2. User

3. Group

4. People in Projects

5. People in Organizations

6. More

   1. Status changed

   2. Resolution set

   3. Fields

Calendar control is used for choosing a date or range of dates:

...

To choose a range, you can click a starting date followed by an ending date of the range. To choose a single day, simply click on a desired date, and if it is part of a selected range, click the same date again. In addition, predefined dates can be chosen from the left panel of the calendar.

After selecting the desired date or range, click Update to confirm the selection.

...

User filter enables you to select a certain user or users on the instance, for which the action log should be displayed in the results. To choose the user, start typing the name, surname, or email of the user. The possible options will be displayed in the dropdown after the first letter:

...

You can select the desired user by checking the checkboxes on the left of the name of the user. The selected users will move to the top of the list:

...

You can clear the selected users with “Clear selected items“.

Besides users, you can select users Group(s), People in Project(s) and/or Organizations(s). After selecting filters, click Generate Activity Log button to see the results based on the selected filters.

More filters

By clicking the “+More“ button, you can also filter the actions by Status changed, Resolution set and Fields:

...

From Status change, you can select the statuses from where or to which the statuses were changed:

...

By typing the status, or selecting from the dropdown, you can choose the statuses in “from“ or “To“ destinations:

...

You can choose several statuses and click the “Apply” button to save the selection:

...

After selecting the statuses, click the “Generate activity log“ button to see the results.

In the same way, you can choose the resolutions, to filter the issues with the selected resolutions. Click the “Resolution set“ option and start typing to search and select the desired resolution. You can choose more than one resolution and click the” Apply” button to save the selection:

...

After selecting the resolutions, click the “Generate activity log“ button to see the results.

You can also search for and select the Fields, to filter the issues where certain fields were updated. Click the “Fields“ option and start typing to search and select the desired field. The list of the fields shows the fields initially added to the Monitored fields in the Settings. You can choose more than one field and click the” Apply” button to save the selection:

...

After selecting the resolutions, click the “Generate activity log“ button to see the results.

JQL Search

You can also enhance search using JQL. If you preliminary have already selected the filters in Basic Search, by toggling to JQL, the filters can be enhanced additionally with JQL. Pre-defined selections will remain and filter the results:

...

With the buttons on the right of the field it is possible to:

• Expand the JQL field;

• See the help page for JQL (will be opened on a new tab);

• Display results based on the JQL term (identical to clicking Generate Activity Log button).

After typing in the JQL term, click Generate Activity Log button to see the results based on the selected filters.

...

Manage Saved Filters

It is possible to save and manage filters for future use. After filling in the filters or JQL, click Save Filter text and fill in the “name” and “description” fields to save the filter:

Image Removed

...

From the popup you can:

• Search saved filters by the name

  • The saved filters will be immediately filtered when you start typing

• Add filter to the favorites

  • Favorite filters will be identified by the filled yellow star ⭐

• Generate Results by clicking the filter name (the popup will close and you will be navigated to the results table)

• View filter:

  • Description

  • Owner

  • Viewers

  • Editors

• Edit filter

  • Edit name and description

• Share filter (see below)

• Delete filter.

You can share the saved filter with other users, user groups, projects, organizations or limit access by choosing the Private option:

...

Results

After clicking Generate Activity Log results will be displayed in the results table. There are three views available: Aggregated View, Detailed View and Issue View.

List of the logged actions

...

Issue created

...

Issue updated

...

Issue deleted

...

Issue resolved

1. Requires initial configuration of the connection to Jira Administration Log.

...

Status changed

1. Requires initial configuration of the connection to Jira Administration Log.

...

Comment added

...

Comment updated

...

Comment deleted

...

Issuelink created

...

Issuelink deleted

...

Worklog created

...

Worklog updated

...

Worklog deleted

...

Project created

...

Project updated

...

Project deleted

...

Project role created *

1. Requires initial configuration of the connection to Jira Administration Log.

...

Project role updated *

1. Requires initial configuration of the connection to Jira Administration Log.

...

Project role deleted *

1. Requires initial configuration of the connection to Jira Administration Log.

...

Project category changed *

1. Requires initial configuration of the connection to Jira Administration Log.

...

User created

1. This action also logs “Invite user“ and “Grant access“ actions from Atlassian Guard

   1. Requires initial configuration of the connection to Atlassian Guard.

...

User updated

...

User deleted

1. This action also logs “Remove user“ and “Revoke access“ actions from Atlassian Guard

   1. Requires initial configuration of the connection to Atlassian Guard.

2. Due to the API restrictions, in case of “user deleted“, the author of the action will be indicated as JIRA.

...

User deactivated (requires Atlassian Guard on the instance)

1. Requires initial configuration of the connection to Atlassian Guard.

...

User reactivated (requires Atlassian Guard on the instance)

1. Requires initial configuration of the connection to Atlassian Guard.

...

User last active

1. The Data/time when the last action of the user was logged either in the Administration, Organization or Assets log.

2. Except for the rare cases after changing the logic of defining last action (10-Jul-2024), only one “last active“ log will be visible in the log.

...

User removed from site (requires Atlassian Guard on the instance)

1. Requires initial configuration of the connection to Atlassian Guard.

...

User invited to site (requires Atlassian Guard on the instance)

1. Requires initial configuration of the connection to Atlassian Guard.

...

User detail changed (requires Atlassian Guard on the instance)

1. Requires initial configuration of the connection to Atlassian Guard.

...

Version released

...

Version unreleased

...

Version created

...

Version moved

...

Version updated

...

Version deleted

...

Option voting changed

...

Option watching changed

...

Option unassigned issues changed

...

Option subtasks changed

...

Option issuelinks changed

...

Option timetracking changed

...

Sprint created

...

Sprint deleted

...

Sprint updated

...

Sprint started

...

Sprint completed

...

Board created (will not be logged for Discovery Project boards)

...

Board updated (will not be logged for Discovery Project boards)

...

Board deleted (will not be logged for Discovery Project boards)

...

Board configuration changed (will not be logged for Discovery Project boards)

...

Assets object created (requires Jira Service Management Premium)

1. Requires initial configuration of the connection to Assets.

...

Assets object updated (requires Jira Service Management Premium)

1. Requires initial configuration of the connection to Assets.

...

Attachment created

...

Attachment deleted

...

Issue type created

...

Issue type updated

...

Issue type deleted

...

Filter created

...

Filter updated

...

Filter deleted

...

Basic Search

Using the basic search, you can define several terms from your Jira instance for filtering the users for which you would like to see the results in the audit log. There are the following options:

1. Calendar

2. Project

3. User

4. Group

5. People in Projects

6. People in Organizations

7. More

   1. Status changed

   2. Resolution set

   3. Fields

Calendar control is used for choosing a date or range of dates:

...

To choose a range, you can click a starting date followed by an ending date of the range. To choose a single day, simply click on a desired date, and if it is part of a selected range, click the same date again. In addition, predefined dates can be chosen from the left panel of the calendar.

After selecting the desired date or range, click Update to confirm the selection.

...

With the Projects you can filter the action in the results that were done in certain projects. The existing projects will be displayed in the dropdown after typing the first letter:

...

User filter enables you to select a certain user or users on the instance, for which the action log should be displayed in the results. To choose the user, start typing the name, surname, or email of the user. The possible options will be displayed in the dropdown after the first letter:

...

You can select the desired user by checking the checkboxes on the left of the name of the user. The selected users will move to the top of the list:

...

You can clear the selected users with “Clear selected items“.

Besides users, you can select users Group(s), People in Project(s) and/or Organizations(s). After selecting filters, click Generate Activity Log button to see the results based on the selected filters.

More filters

By clicking the “+More“ button, you can also filter the actions by Status changed, Resolution set and Fields:

...

From Status change, you can select the statuses from where or to which the statuses were changed:

...

By typing the status, or selecting from the dropdown, you can choose the statuses in “from“ or “To“ destinations:

...

You can choose several statuses and click the “Apply” button to save the selection:

...

After selecting the statuses, click the “Generate activity log“ button to see the results.

In the same way, you can choose the resolutions, to filter the issues with the selected resolutions. Click the “Resolution set“ option and start typing to search and select the desired resolution. You can choose more than one resolution and click the” Apply” button to save the selection:

...

After selecting the resolutions, click the “Generate activity log“ button to see the results.

You can also search for and select the Fields, to filter the issues where certain fields were updated. Click the “Fields“ option and start typing to search and select the desired field. The list of the fields shows the fields initially added to the Monitored fields in the Settings. You can choose more than one field and click the” Apply” button to save the selection:

...

After selecting the resolutions, click the “Generate activity log“ button to see the results.

JQL Search

You can also enhance search using JQL. If you already preliminary have selected the filters in Basic Search, by toggling to JQL, the filters can be enhanced additionally with JQL. Pre-defined selections will remain and filter the results:

...

With the buttons on the right side of the text field, you can:

• Expand the JQL field;

• See the help page for JQL (will be opened on a new tab);

• Display results based on the JQL term (identical to clicking Generate Activity Log button).

After typing in the JQL term, click Generate Activity Log button to see the results based on the selected filters.

...

Manage Saved Filters

It is possible to save and manage filters for future use. After filling in the filters or JQL, click Save Filter text and fill in the “name” and “description” fields to save the filter:

Image Added

The saved filters will appear in the list by clicking Saved filtersbutton:

...

From the popup, you can:

• Search saved filters by the name

  • The saved filters will be immediately filtered when you start typing

• Add filter to the favorites

  • Favorite filters will be identified by the filled yellow star ⭐

• Generate Results by clicking the filter name (the popup will close and you will be navigated to the results table)

• View filter:

  • Description

  • Owner

  • Viewers

  • Editors

• Edit filter

  • Edit name and description

• Share filter (see below)

• Delete filter.

You can share the saved filter with other users, user groups, projects, organizations or limit access by choosing the Private option:

...

Filter subscription

You can also set up a subscription for the filter to receive regular emails with the filter results. To do so, click “Subscriptions“ under the three dots menu, along the filter:

...

If no subscription is configured, you will see the popup to add a new subscription:

...

When you click the “Add subscription“ button, you will see the popup where you can configure a subscription.

Image Added

From here you can add:

• Name - subscription name

• Recipients - email addresses of the subscription recipients (you can add more than one subscriber)

• Schedule

  • Basic - define a desired schedule with the basic scheduler.

  • Advanced - define a desired schedule with CRON expression.

• Checkbox to choose whether to email this filter, even if there are no issues found.

After clicking the Save button, you will be navigated back to the list of the filter subscriptions with the following info:

• Name - the name of the subscription

• Schedule

• Actions

  • Run - receive the email immediately

  • Edit - modify the subscription

  • Delete

• Add subscription - from here you can also add a new subscription for the same filter

...

Results

After clicking Generate Activity Log results will be displayed in the results table. There are three views available: Aggregated View, Detailed View and Issue View.

List of the logged actions

1. Issue created

2. Issue updated

3. Issue deleted

4. Issue resolved

   1. Requires initial configuration of the connection to Jira Administration Log.

   2. Retrieving this action into the app may take up to 30 minutes.

5. Status changed

   1. Requires initial configuration of the connection to Jira Administration Log.

   2. Retrieving this action into the app may take up to 30 minutes.

6. Comment added

7. Comment updated

8. Comment deleted

9. Issuelink created

10. Issuelink deleted

11. Worklog created

12. Worklog updated

13. Worklog deleted

14. Project created

15. Project updated

16. Project deleted

17. Project role created *

    1. Requires initial configuration of the connection to Jira Administration Log.

    2. Retrieving this action into the app may take up to 30 minutes.

18. Project role updated *

    1. Requires initial configuration of the connection to Jira Administration Log.

    2. Retrieving this action into the app may take up to 30 minutes.

19. Project role deleted *

    1. Requires initial configuration of the connection to Jira Administration Log.

    2. Retrieving this action into the app may take up to 30 minutes.

    3. Retrieving this action into the app may take up to 30 minutes.

20. Project category changed *

    1. Requires initial configuration of the connection to Jira Administration Log.

21. User created

    1. This action also logs “Invite user“ and “Grant access“ actions from Atlassian Guard

       1. Requires initial configuration of the connection to Atlassian Guard.

    2. Retrieving this action into the app may take up to 30 minutes.

22. User updated

23. User deleted

    1. This action also logs “Remove user“ and “Revoke access“ actions from Atlassian Guard

       1. Requires initial configuration of the connection to Atlassian Guard.

    2. Retrieving this action into the app may take up to 30 minutes.

    3. Due to the API restrictions, in case of “user deleted“, the author of the action will be indicated as JIRA.

24. User deactivated (requires Atlassian Guard on the instance)

    1. Requires initial configuration of the connection to Atlassian Guard.

    2. Retrieving this action into the app may take up to 30 minutes.

25. User reactivated (requires Atlassian Guard on the instance)

    1. Requires initial configuration of the connection to Atlassian Guard.

    2. Retrieving this action into the app may take up to 30 minutes.

26. User last active

    1. The Data/time when the last action of the user was logged either in the Administration, Organization or Assets log.

    2. Except for the rare cases after changing the logic of defining last action (10-Jul-2024), only one “last active“ log will be visible in the log.

    3. Retrieving this action into the app may take up to 30 minutes.

27. User added to group

    1. Viewing the actor requires the initial configuration of the connection to Atlassian Guard, otherwise the actor will be visible as JIRA.

    2. Retrieving this action into the app may take up to 30 minutes.

28. User removed from group

    1. Viewing the actor requires the initial configuration of the connection to Atlassian Guard, otherwise the actor will be visible as JIRA.

    2. Retrieving this action into the app may take up to 30 minutes.

29. User removed from site (requires Atlassian Guard on the instance)

    1. Requires initial configuration of the connection to Atlassian Guard.

    2. Retrieving this action into the app may take up to 30 minutes.

30. User invited to site (requires Atlassian Guard on the instance)

    1. Requires initial configuration of the connection to Atlassian Guard.

    2. Retrieving this action into the app may take up to 30 minutes.

31. User detail changed (requires Atlassian Guard on the instance)

    1. Requires initial configuration of the connection to Atlassian Guard.

    2. Retrieving this action into the app may take up to 30 minutes.

32. Group created

    1. Retrieving this action into the app may take up to 30 minutes.

33. Group removed

    1. Tis actions triggered when the group is removed from the project.

    2. Retrieving this action into the app may take up to 30 minutes.

34. Group deleted

    1. Retrieving this action into the app may take up to 30 minutes.

35. Api token created

    1. Requires initial configuration of the connection to Atlassian Guard.

    2. Retrieving this action into the app may take up to 30 minutes.

36. Api token revoked

    1. Requires initial configuration of the connection to Atlassian Guard.

    2. Retrieving this action into the app may take up to 30 minutes.

37. Version released

38. Version unreleased

39. Version created

40. Version moved

41. Version updated

42. Version deleted

43. Option voting changed

44. Option watching changed

45. Option unassigned issues changed

46. Option subtasks changed

47. Option issuelinks changed

48. Option timetracking changed

49. Sprint created

50. Sprint deleted

51. Sprint updated

52. Sprint started

53. Sprint completed

54. Board created (will not be logged for Discovery Project boards)

55. Board updated (will not be logged for Discovery Project boards)

56. Board deleted (will not be logged for Discovery Project boards)

57. Board configuration changed (will not be logged for Discovery Project boards)

58. Assets object created (requires Jira Service Management Premium)

    1. Requires initial configuration of the connection to Assets.

    2. Retrieving this action into the app may take up to 60 minutes.

    3. Log visibility depends on the Assets and app permissions ***

59. Assets object updated (requires Jira Service Management Premium)

    1. Requires initial configuration of the connection to Assets.

    2. Retrieving this action into the app may take up to 60 minutes.

    3. Log visibility depends on the Assets and app permissions ***

60. Attachment created

61. Attachment deleted

62. Issue type created

63. Issue type updated

64. Issue type deleted

65. Filter created

66. Filter updated

67. Filter deleted

68. Permission scheme created *

    1. Requires initial configuration of the connection to Jira Administration Log.

    2. Retrieving this action into the app may take up to 30 minutes.

69. Permission scheme copied *

    1. Requires initial configuration of the connection to Jira Administration Log.

    2. Retrieving this action into the app may take up to 30 minutes.

70. Permission scheme deleted *

    1. Requires initial configuration of the connection to Jira Administration Log.

    2. Retrieving this action into the app may take up to 30 minutes.

71. Permission scheme updated *

    1. Requires initial configuration of the connection to Jira Administration Log.

    2. Retrieving this action into the app may take up to 30 minutes.

72. Permission added *

    1. Requires initial configuration of the connection to Jira Administration Log.

    2. Retrieving this action into the app may take up to 30 minutes.

73. Permission deleted *

    1. Requires initial configuration of the connection to Jira Administration Log.

    2. Retrieving this action into the app may take up to 30 minutes.

74. Global permission added *

    1. Requires initial configuration of the connection to Jira Administration Log.

    2. Retrieving this action into the app may take up to 30 minutes.

75. Global permission deleted *

    1. Requires initial configuration of the connection to Jira Administration Log.

    2. Retrieving this action into the app may take up to 30 minutes.

76. Customer permissions changed *

    1. Requires initial configuration of the connection to Jira Administration Log.

    2. Retrieving this action into the app may take up to 30 minutes.

77. Agent Portal Announcement Update Permission *

    1. Requires initial configuration of the connection to Jira Administration Log.

    2. Retrieving this action into the app may take up to 30 minutes.

78. Permission scheme added to project *

    1. Requires initial configuration of the connection to Jira Administration Log.

    Permission scheme copied

    1. Retrieving this action into the app may take up to 30 minutes.

79. Project roles changed *

    1. Requires initial configuration of the connection to Jira Administration Log.

    Permission scheme deleted

    1. Retrieving this action into the app may take up to 30 minutes.

80. JIRA Service Desk configuration *

    1. Requires initial configuration of the connection to Jira Administration Log.

    Permission scheme updated

    1. Retrieving this action into the app may take up to 30 minutes.

81. Login-free portal settings changed *

    1. Requires initial configuration of the connection to Jira Administration Log.

    Permission added

    1. Retrieving this action into the app may take up to 30 minutes.

82. Public signup enabled *

    1. Requires initial configuration of the connection to Jira Administration Log.

    Permission deleted

    1. Retrieving this action into the app may take up to 30 minutes.

83. Public signup disabled *

    1. Requires initial configuration of the connection to Jira Administration Log.

    Global permission added

    1. Retrieving this action into the app may take up to 30 minutes.

84. Requirement for email verification for signup changed *

    1. Requires initial configuration of the connection to Jira Administration Log.

    Global permission deleted

    1. Retrieving this action into the app may take up to 30 minutes.

85. Help center permissions changed *

    1. Requires initial configuration of the connection to Jira Administration Log.

    Customer permissions changed

    1. Retrieving this action into the app may take up to 30 minutes.

86. Help center updated *

    1. Requires initial configuration of the connection to Jira Administration Log.

    Agent Portal Announcement Update Permission *

    1. Retrieving this action into the app may take up to 30 minutes.

87. Scheduled deletion of account

    1. Requires initial configuration of the connection to Jira Administration Log.

    Permission scheme added to project *

    1. Atlassian Guard.

    2. Retrieving this action into the app may take up to 30 minutes.

88. Canceled deletion of account

    1. Requires initial configuration of the connection to Jira Administration Log.

89. Project roles changed *

    1. Requires initial configuration of the connection to Jira Administration Log.

90. JIRA Service Desk configuration *

    1. Requires initial configuration of the connection to Jira Administration Log.

91. Login-free portal settings changed *

    1. Requires initial configuration of the connection to Jira Administration Log.

92. Public signup enabled *

    1. Requires initial configuration of the connection to Jira Administration Log.

93. Public signup disabled *

    1. Requires initial configuration of the connection to Jira Administration Log.

94. Requirement for email verification for signup changed *

    1. Requires initial configuration of the connection to Jira Administration Log.

95. Help center permissions changed *

    1. Requires initial configuration of the connection to Jira Administration Log.

96. Help center updated *

    1. Requires initial configuration of the connection to Jira Administration Log.

97. Issue view

...

1. 1. to Atlassian Guard.

   2. Retrieving this action into the app may take up to 30 minutes.

2. Assets roles updated

   1. The action is logged every 30 minutes **

   2. Log visibility depends on the Assets and app permissions ***

3. Assets object type roles updated

   1. The action is logged every 30 minutes **

   2. Log visibility depends on the Assets and app permissions ***

4. Issue view

Aggregated View

The Aggregated view shows all the actions based on action authors in the rows:

...

You can check or uncheck “Select all“ checkbox to select all or none of the columns. Clicking “Reset default”, will select the default columns (Issue Created, Issue Updated, Issue Deleted, Issue Changed, Status Resolve, Issue Commented, Comment Updated and Comment Deleted).

...

Additionally, you can filter the data based on transitioned statuses. Click +More button across the use filters and select Status changed and/or Resolution set:

...

After selecting the option(s) you will see the additional filters below the user filters:

...

Click Status Change button and choose “from“ and “to“ from the available statuses list (you can select more than one status):

...

When you select the desired statuses, click Apply button and Generate activity log to filter the actions:

...

In the same way, you can filter the actions by the Resolutions:

...

...

Results Breakdown

Additionally, you can break down the results in the aggregated view by:

• Project

• Destination status

• Transition

• Issues [coming soon!]

• Fields [coming soon!]

Breakdown by Projects

You can break the actions down by projects. To do so, click Breakdown button and select Projects:

...

You can break the actions down by the destination status to see how many times the user transitioned the issue into the statuses. To do so, click Breakdown button and select Status.

...

You can break the actions down by the transitions to see how many times the user transitioned the issue from one status to another. To do so, click Breakdown button and select Transition.

...

You can break the action by the issues. To do so, Breakdown button and select Issues.

...

You can break the action by the fields that were updated. To do so, Breakdown button and select Fields.

...

For each action you can see the following information:

...

• User who did the action

• Which action was done

• When the action was done

• The affected object

  • In case of issues:

    • Issue key

    • Issue type

    • Issue summary

    • Request type

    • You can see the issue key and can open the issue by clicking Open button.

• Changes

  • Old value and new value

    • Some of the actions (e.g. “Version released”, “Version unreleased” and , “Asset Created” actions does ) do not have Changes section.

...

...

You can see the following information in the list:

...

You can also export the Issue views in Excel format by clicking “Export (.xlsx)“ button.

...

Export history

From the app Header → Export history, you can view all the exports made by the users:

...

In case of the Saved filters, you will be able to click the Filter name (in blue) and the saved filter will open. For the unsaved filter, “custom“ will be shown in the Filter name.

...

If you are configuring the webhooks for the first time, you will see a popup with “+ Add URL endpoint“ button:

...

When you click “+ Add URL endpoint“ button, you will see a window where you can generate you access token for the API:

...

Name the endpoint and click “Generate access token” button to generate a token:

...

Click Add Token button to save the token:

...