Skip to content
  • There are no suggestions because the search field is empty.

Step 5: Create & connect a parser

What is a Parser?

In the world of data monitoring, a parser acts like a translator between raw data and your monitoring system. Think of it as a specialized interpreter that takes complex, often cryptic data formats and transforms them into a structured, readable format that Proqio can understand and process.

Creating a parser

Step 1: Initiating a New Parser

  1. Navigate to the Monitoring section
  2. Click on the "Connectivity" tab
  3. Select "Parsers" section
  4. Click the "Create Parser" button in the top-right corner

create a parser

Step 2: Basic Parser Configuration

In the "Create Parser" dialog, you'll need to provide:

  • Name: A unique identifier for your parser
    • Example: "Crackmeter", "WeatherStation", "VibrationSensor"
    • Choose a name that clearly describes the data source
  • Timezone: Select the appropriate timezone for your data source
    • This ensures accurate time-stamping of your measurements
    • Proqio supports multiple global timezones
  • Description (Optional):
    • Add context about the parser's purpose
    • Helpful for team collaboration and future reference

Step 3: JSON Code Configuration

The JSON configuration is the heart of your parser. It defines how raw data will be interpreted. Here an example:

{
    "body": {
        "delimiter": ";",
        "rowBlocks": [
            {
                "repeat": true,
                "rowBlockGroups": [
                    {
                        "repeat": 1,
                        "colBlocks": []
                    }
                ]
            }
        ]
    }
}

JSON Structure

  • delimiter: Specifies the character separating data fields (e.g., semicolon, comma)
  • rowBlocks: Defines how rows of data are structured
  • repeat: Indicates whether the block can have multiple instances
  • rowBlockGroups: Allows for complex, nested data parsing
  • colBlocks: Will contain specific column parsing instructions

Troubleshooting Common Parser Issues

  • Incorrect Delimiter: Double-check the delimiter in your JSON configuration
  • Timezone Mismatches: Ensure the selected timezone matches your data source
  • Parsing Errors: Verify the structure of your input data matches the parser configuration
  • Missing Data: Review your column block definitions for completeness

Step 4: Testing Your Parser

  1. Optionally, upload a CSV file to do a practical test
  2. Review the test results to ensure data is parsed correctly

Step 5: Linking the Parser

In the Connectivity > Connections section:

  1. Find the connection related to your data source
  2. Link the newly created parser to this connection
  3. Verify the connection is receiving the data

connect parser