# Flow Builder Logs

**Flow Builder Logs** are a section of your Flow Builder experience where you can see a list of all Invocations for a  Flow. Invocation counts as every time a Flow has been triggered.

<figure><img src="/files/d5bCXknzAO85IQrhNu5l" alt=""><figcaption></figcaption></figure>

#### Table of contents <a href="#id-01gdd5r2bhjv6z57p18c5qrkt7" id="id-01gdd5r2bhjv6z57p18c5qrkt7"></a>

* [Flow Builder Logs Overview](#01GDD5S7JPZE7R2W3VKPJ17Q0J)
* [Searching and Filtering](#01GDD5S3DDZW56KBB79D2AHG5C)
* [Troubleshooting in Flow Builder Logs](#01GDD5RZ6N8E9WZD4JHA2AZJRA)

#### Before getting started <a href="#id-01gdd5qwrmbnqm2ec5jyaek5pf" id="id-01gdd5qwrmbnqm2ec5jyaek5pf"></a>

You will need:

* A [MessageBird account](https://dashboard.messagebird.com/)

#### Flow Builder Logs Overview <a href="#id-01gdd5s7jpze7r2w3vkpj17q0j" id="id-01gdd5s7jpze7r2w3vkpj17q0j"></a>

The Logs for a Flow can be accessed by visiting a Flow and selecting the Logs tab in the upper left corner:<br>

<figure><img src="/files/p9GbKXoz6vkJPlJ6H9sU" alt=""><figcaption></figcaption></figure>

or by using the quick link next to the name of a Flow:<br>

<figure><img src="/files/8FuwqKD2xh9Q1JkdJHVl" alt=""><figcaption></figcaption></figure>

The **Logs** page consists of the following:

* Searching and Filtering section
* Invocations status breakdown section
  * Total number of Invocations
  * Number and percentage of:
    * ***successful*** invocations-> completed invocations
      * 📝 in invocations containing [Inbox](https://inbox.messagebird.com/) related steps, an invocation will be marked as successful only once the ticket created in Inbox is resolved
    * ***in progress*** invocations -> invocations that are still being executed
      * 📝 in invocations containing [Inbox](https://inbox.messagebird.com/) related steps, an invocation will remain in progress until the ticket created in Inbox is resolved
    * ***expired*** invocations -> invocations in which a Step condition has expired
      * ex. a time condition in a [*Wait for a response*](/connectivity-platform/steps-catalogue/using-the-wait-for-a-response-step-in-flow-builder-video.md) step has expired (the end-user has not replied
      * ex. a time condition in an [*Await webhook*](/connectivity-platform/basics/flowbuilder-steps-glossary.md#id-01g1jen5k3hqacptnejekwb75t) step has expired (the webhook was not triggered)
    * ***failed*** invocations -> invocations that have failed due to an error in the execution
    * ***canceled*** invocations -> invocations that have been canceled before completion by using the cancellation option:

<figure><img src="/files/Nn4Mr40f3j30W3fcnVPj" alt=""><figcaption></figcaption></figure>

* List of Invocations

If needed, you can also export your Logs by following the instructions [here](https://support.messagebird.com/hc/en-us/articles/9975558266129).

#### Searching and Filtering <a href="#id-01gdd5s3ddzw56kbb79d2ahg5c" id="id-01gdd5s3ddzw56kbb79d2ahg5c"></a>

When searching for a specific end user's interaction, or a time frame, use the *Filtering* feature:

<figure><img src="/files/9mpG3SN5voruo0EcZWyO" alt=""><figcaption></figcaption></figure>

* Define if you are filtering by:
  * Invocation status
  * Invocation variables
  * Full-text search across variables and failure details
* And don't forget to hit the *Apply filters* button to get the desired results:

<figure><img src="/files/kiVA81v4tTlAsVK8MnGH" alt=""><figcaption></figcaption></figure>

#### Troubleshooting in Flow Builder Logs <a href="#id-01gdd5rz6n8e9wzd4jha2azjra" id="id-01gdd5rz6n8e9wzd4jha2azjra"></a>

By clicking on any Invocation, a detailed overview of the Invocation will open up:

<figure><img src="/files/B8PPaI6ib4myDo1bjgyg" alt=""><figcaption></figcaption></figure>

The detailed overview of Invocations offers insights into the following:

* Status of the Invocation
* Start and end time of an Invocation
* All the variables present in an Invocation
* A handy overview of all the Steps triggered:
  * The name and the id of the Step
  * The status of every Step
  * List of variables used in a Step
  * The timestamp of the creation of the Step record&#x20;

The information listed above offers details and insights that will ease any troubleshooting you might want to perform. Combined with the *Search & Filter* feature, you can pinpoint specific end-users, timeframes, variables, and failure causes. Check out how to search through Flow Builder Logs [here](https://support.messagebird.com/hc/en-us/articles/9481662352017).

📤  Feel free to [contact our Support](https://support.messagebird.com/hc/en-us/requests/new) in case you might need some help!


---

# Agent Instructions: 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:

```
GET https://docs.bird.com/connectivity-platform/troubleshoot-a-flow/flow-builder-logs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.