When investigating an application error or poor performance, you may want to see whether any application changes occurred at the same time as the error or issue.
AppDynamics automatically detects and reports common application change events, such as app server restarts or changes to application environment variables. You can supplement automatically detected change events with custom application change events, generated either through the UI or through the REST API.
Application changes appear alongside other events in the events list. Like other types of events, you can view details for the event by double-clicking on it or see them in the context of other performance indicators, as described below. They can also serve as triggering conditions for policies.
Manually Registering Application Changes
You can add an application change event to AppDynamics manually.
This capability allows you to log a change event, in effect, which might not otherwise be detected by AppDynamics. Controller users can then correlate the event to performance data later. For example, you may want to create an event when you push an updated version of the application.
To create an application change event manually:
- In the Events List, expand the Actions menu and choose Register Application Change Event. For information on accessing the events list, see Monitor Events.
- In the Register Application Change dialog, configure the event. You can choose the type of event, the scope, and the time when the event should be registered.
- Click the Register Application Change Event button. If Now is selected as the change time, the event appears in the events list immediately:
Double-click on the event in the list to view more details about the event, including any actions triggered by the event as a result of a policy.
Automatically Registering Application Changes
The AppDynamics REST API provides an alternative to creating application change events in the UI.
The API lets you automate event registration, so that external systems can generate events based on their own activities or conditions. For example, you can configure your release management system to generate an event in AppDynamics when it deploys an update to the application code, allowing you to correlate that event with application performance.
Correlating Application Changes With Other Events
You can view application changes in the context with other events and performance indicators in a various Controller UI pages. The following steps describe how to view them in the transaction score histogram.
To view application changes with other events in Transaction Score:
- In the Application Dashboard click the Transaction Score tab.
- Click Show Events.
- Click show event filters.
- Check Application Changes in the filters list and then click Search.
Application change events appear in the histogram, where they appear in the context of other performance indicators.