Use Cases/Guides

Ingest Pump Logs

SitePro Ingest Pump Logs

SitePro APIs allow you to ingest pump telemetry logs from remote devices and edge systems into a centralized, normalized data model. By publishing pump logs to SitePro, developers can visualize aggregated min, avg, and max values across key setpoints - including frequency, head pressure, suction pressure, output current, and output voltage - over configurable time intervals. This guide walks through how to securely send pump logs to SitePro and make them available for monitoring, trend analysis, and downstream integrations.

How it works:

  1. Pump collects data readings
  2. Data is formatted to SitePro's schema (shown below)
  3. Readings are sent to SitePro's ingestion endpoint
  4. Data becomes available for Visualization, alarms, and reporting

Steps on ingesting a single log into SitePro:

  1. Use your log-in credentials to obtain your token
  2. Place your token into your authorizaton field
  3. Create POST to https://platform.sitepro.com/v1/edge/logs/pump
  4. Use the following format for your log info:

Request Body

  {
    "sitePumpID": 123, // Unique identifier of the pump. (required)
    "timestamp": "2024-01-01T00:00:00.000Z", // ISO UTC timestamp of when the reading was taken. (required)
    "startTimestamp": "2023-12-31T23:00:00.000Z", // ISO UTC timestamp of when the pump run started.
    "frequency": 60, // Pump frequency.
    "outputCurrent": 12.5, // Output current of the pump.
    "outputVoltage": 230, // Output voltage of the pump.
    "pressure": 150, // Discharge pressure reading.
    "suctionPressure": 80, // Suction pressure reading.
    "vibrationLevel": 1.2, // Vibration level reading.
    "igbtTemperature": 65, // IGBT temperature reading.
    "capacitanceTemperature": 55, // Capacitance temperature reading.
    "autoEnabled": true, // Whether the pump is in automatic mode.
    "fault": false, // Whether the pump is in a fault state.
    "underAlarm": false, // Whether the pump is under alarm.
    "running": true, // Whether the pump is currently running.
    "active": true, // Whether the pump is active.
    "targetConcentration": 10, // Target chemical concentration.
    "actualConcentration": 9, // Actual chemical concentration.
    "injectionRate": 5, // Chemical injection rate.
    "statusID": 2, // Identifier of the pump's status.
    "status": "Running" // Human-readable status of the pump.
  }

Response

  Single log processed successfully.