Skip to content
Globe Tracker Documentation

Retrieving Push Results

You can access delivery results and logs for all push methods (HTTP, MQTT, and Kafka) in the same way. This allows you to monitor delivery status, inspect payloads, and troubleshoot issues regardless of the push technology you use.

Overview

Section titled “Overview”

For every push delivery attempt, Globe Tracker stores detailed metadata and results. You can retrieve this information using the Flowcore CLI, the data-pump SDK, or the Globe Tracker dashboard.

Available Methods

Section titled “Available Methods”

1. Using the Flowcore CLI

Section titled “1. Using the Flowcore CLI”

You can extract push logs for the last day (or any time window) using the Flowcore CLI. Replace the stream name with the appropriate one for your push type:

  • HTTP Push:

    Terminal window
    flowcore stream https://flowcore.io/globe-tracker-aps/example-data/push-results.0/created.0.stream \
      --no-live \
      -s 1d \
      --payload \
      --json

  • MQTT Push:

    Terminal window
    flowcore stream https://flowcore.io/globe-tracker-aps/example-data/mqtt-push-results.0/created.0.stream \
      --no-live \
      -s 1d \
      --payload \
      --json

  • Kafka Push:

    Terminal window
    flowcore stream https://flowcore.io/globe-tracker-aps/example-data/kafka-push-results.0/created.0.stream \
      --no-live \
      -s 1d \
      --payload \
      --json

Command options:

  • --no-live: Get historical data only
  • -s 1d: Get data for the last day (use 12h for 12 hours, 7d for 7 days, etc.)
  • --payload: Include only the payload and not Flowcore metadata
  • --json: Output in JSON format

2. Using the data-pump SDK

Section titled “2. Using the data-pump SDK”

You can use the data-pump NPM package to retrieve push results programmatically. The SDK supports filtering by time, event type, and more.

3. Using the Dashboard

Section titled “3. Using the Dashboard”

The Globe Tracker dashboard provides a user-friendly interface to:

  • View delivery history for all push types
  • Check delivery status and response codes
  • Inspect payload contents for errors
  • Track retry attempts and final delivery status
  • View stored receipt IDs and response metadata
  • Monitor rate limiting and performance metrics

Contact your Globe Tracker representative to get access to your dashboard.

What Information is Available?

Section titled “What Information is Available?”

For each delivery attempt, the following metadata is available:

  • Timestamp of the attempt
  • Push type (HTTP, MQTT, Kafka)
  • Delivery status (success/failure)
  • Response or acknowledgement details
  • Error details (if any)
  • Payload contents
  • Customer receipt ID (if provided)
  • Retry attempts and final status

Example: Filtering by Time Window

Section titled “Example: Filtering by Time Window”

You can adjust the time window in the CLI or SDK to retrieve results for a specific period. For example, to get results for the last 12 hours:

Terminal window
flowcore stream https://flowcore.io/globe-tracker-aps/example-data/push-results.0/created.0.stream \
  --no-live \
  -s 12h \
  --payload \
  --json

Summary

Section titled “Summary”

No matter which push method you use (HTTP, MQTT, or Kafka), you can retrieve delivery results and logs using the same tools and processes. This unified approach makes it easy to monitor, debug, and optimize your integration with Globe Tracker’s real-time data delivery platform.