# 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="https://675349995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUJNEE9TMK4fU91VKstBr%2Fuploads%2Fgit-blob-7ca5c6e6c085b7b505cf53e165845b89faf03c83%2F9975992639249?alt=media" 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="https://675349995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUJNEE9TMK4fU91VKstBr%2Fuploads%2Fgit-blob-3142d2f7e34ad854197a8352c89ee0cd9bcfa5bb%2FLogs_Gif.gif?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://675349995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUJNEE9TMK4fU91VKstBr%2Fuploads%2Fgit-blob-bf9f85ebd4d7b422de3abb4b30baf6ce8ce00f32%2FQuick_link.jpg?alt=media" 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*](https://docs.bird.com/connectivity-platform/steps-catalogue/using-the-wait-for-a-response-step-in-flow-builder-video) step has expired (the end-user has not replied
      * ex. a time condition in an [*Await webhook*](https://docs.bird.com/connectivity-platform/basics/flowbuilder-steps-glossary#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="https://675349995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUJNEE9TMK4fU91VKstBr%2Fuploads%2Fgit-blob-e863e5d9f37231d5fd749889d670071699bf429e%2F9666959879057?alt=media" 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="https://675349995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUJNEE9TMK4fU91VKstBr%2Fuploads%2Fgit-blob-38611b04b3f4f8d052bc1664d4222278e364aea4%2FFiltering.jpg?alt=media" 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="https://675349995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUJNEE9TMK4fU91VKstBr%2Fuploads%2Fgit-blob-c74068cd2b73b6030e0169f55e1d28818792ecee%2FFiltering_Gif.gif?alt=media" 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="https://675349995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUJNEE9TMK4fU91VKstBr%2Fuploads%2Fgit-blob-399c5b906eb7db1d4cb3319a7ac48fd781627341%2FSingle_invocation.gif?alt=media" 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!