This article applies as of PRTG 22

Monitoring Sigfox geolocation with PRTG

Sigfox Geolocation is a low-energy location service for devices that are equipped with a Sigfox module, without the need for GPS. For each message sent by a device, Sigfox Geolocation provides real-time coordinates and the location within a few hundred meters up to a kilometer, delivered through a callback, for example.

With PRTG, you can monitor Sigfox devices with the HTTP IoT Push Data Advanced sensor.

Create an HTTP IoT Push Data Advanced sensor

The first step to monitoring Sigfox Geolocation is to add an HTTP IoT Push Data Advanced sensor to your PRTG installation.

1. Create a new device or use an existing device and enter 127.0.0.1 as the IPv4 Address/DNS Name.
2. Add an HTTP IoT Push Data Advanced sensor to the device.
3. Note the TLS Port 5051 and the Identification Token, you need both values when setting up your Sigfox callback configuration, so copy them.

Create a Sigfox callback

The next step to monitoring Sigfox Geolocation is to create the corresponding callback in the Sigfox interface.

Click to enlarge.

1. Open Callbacks.
2. Select the Device Type tab.
3. Under Type, select Service and Geoloc.
4. Under Channel, select URL and enter the following URL. https://<probe_IP>:5051/<token>Note: You can reference the Sigfox Id as {device} in your <token>.
   
5. Replace <probe_IP> with the IP address of the probe system where the HTTP IoT Push Data Advanced sensor runs.
6. Replace <token> with the Identification Token that you defined in the sensor settings.
7. Change the Content type to application/json
8. Add the following JSON to the Body field

{
  "prtg": {
    "text": "OK",
    "result": [
          {
                "channel": "Latitude",
            	"float": 1,
                "value": {lat}
            
          },
          {
                "channel": "Longitude",
            	"float": 1,
                "value": {lng}
            
          },
          {
                "channel": "Accuracy",
                "value": {radius}
            
          }
    ]
  }
}

9. Click Ok to save the callback.

Device settings in PRTG

1. Copy the ID of the HTTP IoT Push Data Advanced sensor. In this example, it is 2557.
   Click to enlarge.
   
2. In section Location of the settings of the device to which you added the sensor, disable the inheritance of settings.
3. Enter the following under Location (for Geo Maps): SigfoxTest{"id":<sensorid>,"count":1,"waypointstyle":null,"waypointmarker":2,"style":{"strokeColor":"#0404B4","strokeOpacity":0.0,"strokeWidth":4,"fillColor":"#0000ff","fillOpacity":0.1}}
   
4. Replace <sensorid> with the sensor's ID, which is 2557 in this example.
5. Save your settings.

The geographical map now shows the Sigfox Geolocation, including the expected radius in which the device is located.
Click to enlarge.

More

• How can I monitor Sigfox callbacks with PRTG?
• How can I monitor the Sigfox API with PRTG?