***

title: Errors
description: Learn about errors in Fynapse.
subtitle: A guide to errors in Fynapse.
---------------------------------------

## Overview

The **Errors** screen available in the **Error Management** menu allows you to view all processing errors thrown in Fynapse. Additionally, you can filter the content of the grid using the Query panel to create flexible queries.

## Errors Screen

The **Errors** screen comprises the following elements:

* The **Query** panel - use it to create a query to limit the results displayed in the grid.
  <Callout intent="tip">
    If a query returns more than 100,000 records, only 100,000 records are displayed in the grid.
  </Callout>
  This panel comprises:
  * The **Saved criteria** panel - use it to select one of the queries that you ran and saved earlier. Keep in mind, that saved queries are visible only to users that created them. The panel contains:
    * The **More** menu - click it to access more options:
      * **Set as default** - click it to set the selected saved query criteria to be a default one, that is it will be automatically run upon entering the screen, the grid will display its results, and the query configuration will be visible in the **Criteria** panel. Only one default can be set per one user and one Entity.
      * **Unset default** - click it to unset the selected saved query criteria from being the default one. This means that upon entering the screen the default Fynapse query will be set and the grid will display results from the current day and last 7 days.
      * **Delete** - click it to delete the selected saved query criteria
    * The **Apply criteria** chevron - click it to open the selected saved query criteria
  * The **Criteria** panel - use it to define criteria for the query that you want to run. The panel contains:
    * The **Attributes** list - use it to select the attributes that you want to use to create a condition and define the query. You can select as many as you need.
    * The **Add** button - click it to add another operator to the particular attribute. At least one operator must be defined for the attribute
    * The **Match any** button - click it if one of the defined conditions has to be met
    * The **Match all** button - click it if all defined conditions have to be met
    * The trash bin icon - click it to delete a particular operator
  * The action buttons:
    * **Search** - click it to run the defined query and display its results in the grid
    * **Overwrite** - click it to introduce changes to the saved query criteria
    * **Save as new** - click it to save the defined query so that you do not have to create it again. The name of the query criteria must be unique for the particular user and Entity.
      <Callout intent="tip">
        If some of the query attributes that you saved in your query are not available anymore (they were deleted externally from the system), you will be notified about it.
      </Callout>
    * **Clear** - click it to clear the defined query. If you selected the saved criteria and clicked the **Clear** button, then its attributes will be cleared but they will not be deleted permanently until you decide to save this action by clicking the **Overwrite** button.

* The grid - use it to see the list of errors. The grid displays a subset of all database entries, that is, up to 100,000 records. By default, when you enter the screen entries from the current day and the last 7 days are displayed in the grid. To see results from a different time range, modify the query. Errors are sorted descending by date (they are arranged from the latest and most recent ones to the oldest ones). The grid has the following columns:
  * **Entity key** - a unique ID that allows you to identify the record
  * **Entity namespace** - a namespace to which the data record type belongs
  * **Entity name** - the data record type that caused the error
  * **Ingestion ID** - an ingestion ID assigned to an ingestion file from which the data record was ingested into the system
  * **Technical origin** - a name of a module where the processing failed, for example, Accounting Engine, Journal processor
  * **Technical ID** - Internal Use Only
  * **Severity** - the type of a log record:
    * Error
    * Warning
  * **Category** - which type of controls were triggered by the record and caused the error to be thrown
  * **Subcategory** - more detailed information about the type of controls triggered
  * **Message** - the error message thrown
  * **Event timestamp** - the date and time when the error was generated

In addition, you can:

* Set a column visibility by clicking the three dot icon next to the name of the column, then selecting or clearing a checkbox next to the column name that you want to hide or show, and clicking the **Apply** button
* Change the size of columns by dragging the edges of the header cells
* Change the order of columns by dragging and dropping them to the proper place

Additionally, at the bottom of the screen, you can:

* See the number of pages that display errors and buttons to navigate between pages
* See information which page you are currently viewing and how many pages are available in total
* Decide how many results you want to display on one page
* See how many results were returned by the query

## Tutorials

<AccordionGroup>
  <Accordion title="How to Export Errors to a File?">
    1. Go to **Configuration > Extraction**.
    2. Create an extract configuration for errors or run an already created extract configuration. To learn more about creating and running extract configurations, read the tutorials available in the [Extract Configuration](/docs/processing-configuration/data-extraction/extract-configuration) chapter.
    3. Go to **Integration > Extraction** to check if the extraction process is finished.
    4. In the grid, find an extract file generated by the extraction process (its **Target status** must be **Sent**).
    5. Click the extract file name and wait for the download process to start.
  </Accordion>

  <Accordion title="How to Save a Query?">
    1. Go to **Error Management > Errors**.
    2. In the **Criteria** panel, create a query:
       1. Click in the **Attributes** field and select as many attributes as you need.
       2. For each attribute define at least one operator to create a condition. To add more operators, click the **Add** button.
    3. Click the **Save as new** button.
    4. The new dialog opens where you provide a unique name for the query.
    5. Select the **Set as default** checkbox if you want it to be run automatically upon entering the screen.
    6. Click the **Save as new** button. The query will be saved and will be displayed in the **Saved criteria** panel.
  </Accordion>

  <Accordion title="How to Overwrite a Saved Query?">
    1. Go to **Error Management > Errors**.
    2. In the **Saved criteria** panel, find a saved query that you want to edit.
    3. Click the **Apply criteria** chevron next to this query. The query opens in the **Criteria** panel.
    4. Make necessary changes.
    5. Click the **Overwrite** button.
    6. The new dialog opens where you confirm an action by clicking the **Overwrite** button. The changes will be applied and saved.
  </Accordion>

  <Accordion title="How to Set a Saved Query as Default?">
    1. Go to **Error Management > Errors**.
    2. In the **Saved criteria** panel, find a saved query that you want to set as a default one.
    3. Click the **More** menu.
    4. Click the **Set as default** option. The query will be marked as the default one. It will be automatically run upon entering the screen, the grid will display its results and the query configuration will be visible in the **Criteria** panel.
  </Accordion>

  <Accordion title="How to Delete a Default Option from a Selected Saved Query?">
    1. Go to **Error Management > Errors**.
    2. In the **Saved criteria** panel, find a saved query that you do not want to be a default one.
    3. Click the **More** menu.
    4. Click the **Unset default** option. The selected saved query will not be marked as the default anymore. Until you set as default another query, the default Fynapse query will be set and the grid will display results from the current day and the last 7 days.
  </Accordion>

  <Accordion title="How to Delete a Saved Query?">
    1. Go to **Error Management > Errors**.
    2. In the **Saved criteria** panel, find a saved query that you want to delete.
    3. Click the **More** menu.
    4. Click the **Delete** option.
    5. The new dialog opens where you confirm an action by clicking the **Delete** button. The selected saved query will be deleted.
  </Accordion>

  <Accordion title="How to Open and Apply a Saved Query?">
    1. Go to **Error Management > Errors**.
    2. In the **Saved criteria** panel, find a saved query that you want to apply.
    3. Click the **Apply criteria** chevron. The query opens in the **Criteria** panel.
    4. Click the **Search** button to run the query. The errors returned by this query will be displayed in the grid.
  </Accordion>
</AccordionGroup>

## Learn More

* [Consolidated Error List](/docs/data-management/error-management-service/consolidated-error-list)
* [Reprocessing Configuration](/docs/data-management/error-management-service/reprocessing-configuration)