Release Version: AlphaRelease VersionAlpha

The Earthsense (Zephyr) source imports time-series measurements from one selected Zephyr through EarthSense’s modern Zephyr API.

Setup

Prerequisites

Before setting up this integration, make sure you have:

  • Your EarthSense account username and password
  • Access to the Zephyr you want to import

Credential Setup

Use Earthsense (Zephyr) Credentials to create or select the credential for this integration. IMSURGE uses the credential to list available devices during setup and to read data during pipeline runs.

Integration Setup

After selecting the Earthsense (Zephyr) credential, select one Zephyr from the devices available in your EarthSense account.

  • znumber - The EarthSense API identifier for the selected Zephyr.

Select the device by its displayed serial number (serialNumber). If a serial number is unavailable, the option is labelled Zephyr <znumber>. The selected value is always the device’s znumber.

Reference

Credential fields are documented in Earthsense (Zephyr) Credentials.

Field Description Required
znumber Zephyr to read from, selected by its displayed serial number. ✓

This integration uses Data Pull.

IMSURGE retrieves unaveraged measurements from both cartridges for the pipeline execution time range. Request timestamps are converted to UTC.

This integration supports Manual Execution.

Execution Type Data Range
Default mode Pull all data since the last data point received.
Backtrack Up to 7 days (IMSURGE limit)

EarthSense does not document a historical retention limit.

Output Description
Device One IMSURGE device for the selected Zephyr, identified by its EarthSense serial number (serialNumber). The znumber is the API and configuration identifier.
Metrics Created dynamically from the measurement fields returned by EarthSense. IMSURGE requests all available measurement fields rather than a fixed list.
Units Taken from EarthSense measurement metadata and normalized using IMSURGE’s standard unit handling.

Limitations

  • Metric availability - Available measurements depend on the Zephyr configuration. They may include gases, particulate measurements, temperature, humidity, ambient conditions, and optional MET fields. Not every device exposes every measurement.
  • Location - Latitude and longitude measurement series are not exposed as metrics or used to infer a device location. Device-level coordinates are optional, not required or assumed; EarthSense does not document them in device metadata.
  • Alpha Integration - Earthsense (Zephyr) is an alpha integration. Results may vary while the integration is being validated.