Data ManagementError Management Service

Errors

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.

    If a query returns more than 100,000 records, only 100,000 records are displayed in the grid.

    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.

        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.

      • 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

  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 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.
  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.
  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.
  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.
  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.
  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.
  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.

Learn More