> For the complete documentation index, see [llms.txt](https://docs.appfactor.io/52eJroWboQfTwsFl14gL/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.appfactor.io/52eJroWboQfTwsFl14gL/quickstart-guide/event-log.md).

# Event Log

## Event Log

The Event Log provides a chronological view of all system and user activities related to assessments, deployments, and rollbacks. It is the primary place to track progress, diagnose failures, and understand what happened and why.&#x20;

### System vs User events

<img src="https://3117893838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FepYt9QlYazTOKSlt9tWX%2Fuploads%2FX27g5Ej9gLbTW0M3xlwb%2FScreenshot%202026-02-05%20at%2015.02.48.png?alt=media&amp;token=3c5c5ec9-9270-411c-8e4f-1086b2b0681b" alt="" data-size="line"> **System** will show you a log activities and messages that are initiated by the set of backend systems and engines that execute processes&#x20;

<img src="https://3117893838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FepYt9QlYazTOKSlt9tWX%2Fuploads%2FEa0qMWdqSVCgYZ52ugRa%2FScreenshot%202026-02-05%20at%2015.03.32.png?alt=media&amp;token=081e6be9-e32a-4479-88ad-6dd93c264aab" alt="" data-size="line"> User will show your all events that were initiated by user request

<img src="https://3117893838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FepYt9QlYazTOKSlt9tWX%2Fuploads%2FnsIfVSiO833VPG6PGRXv%2FScreenshot%202026-02-05%20at%2015.04.01.png?alt=media&amp;token=3ab07930-abfb-45ac-9269-2886eef16e31" alt="" data-size="line"> All will show you all events traced by the system

***

## Event List Table

Clicking on an event will allow you to see the full details of the message. The JSON text area with the details of the event can be copied by selecting the copy icon <img src="https://3117893838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FepYt9QlYazTOKSlt9tWX%2Fuploads%2FNa4wy1lnudQJgZMgF07r%2FScreenshot%202026-02-05%20at%2015.05.20.png?alt=media&amp;token=355d9a2d-e9e7-442b-b6da-1e2c0a26b4f1" alt="" data-size="line"> on the text field below.

<figure><img src="https://3117893838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FepYt9QlYazTOKSlt9tWX%2Fuploads%2FDD9lIjX9rPv30W302o39%2FScreenshot%202026-02-05%20at%2015.00.16.png?alt=media&amp;token=7bd7effd-129c-4f22-b5d4-3b2e83cca437" alt="" width="563"><figcaption></figcaption></figure>

You can filter and search the events for specific keywords using the search bar on the top right of the page.

#### Event Table Columns

* **Type**\
  Indicates the category of activity, such as:
  * *Assessment Progress*
  * *Deployment Progress*
  * *Rollback Progress*
* **Time**\
  Timestamp of when the event occurred. Sorting by time helps reconstruct the execution flow.
* **Status**\
  Visual indicator of the event outcome:
  * 🟢 **Completed** – step finished successfully
  * 🔵 **In progress** – step currently executing
  * 🔴 **Failed** – error occurred, action did not complete
* **Message**\
  Human-readable description of the action, including:
  * What is being executed
  * IDs of deployments/actions
  * Error details when failures occur

***

## How to Read the Log

### Follow the Flow

Events are logged **step by step**. Read **top to bottom** (or reverse by time) to understand:

1. What started
2. What executed
3. Where it failed or completed
4. Whether rollback was triggered automatically

Example:

* *Assessment started* → *Assessment completed*
* *Deployment executing* → *Deployment failed*
* *Rollback initiated automatically* → *Rollback completed*

### Identifying Failures

* Look for **red “Failed”** entries.
* Read the **error message carefully** — it often includes:
  * Configuration issues
  * Validation errors
  * Missing cloud resources (e.g. Log Analytics workspace)
* Failures are typically followed by **automatic rollback events**, which are clearly logged.

### Understanding Rollbacks

When a deployment fails:

* The platform **automatically triggers a rollback**
* Rollback steps are logged individually
* A final **“rolled back successfully”** message confirms the environment was restored to its previous state

This ensures deployments are **safe and reversible**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.appfactor.io/52eJroWboQfTwsFl14gL/quickstart-guide/event-log.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
