Skip to main content

Komatsu Komtrax Connector

Status: Planned: not built. The maker does not publish its protocol or interface; ZAITRACK builds it once it does.

KindVersionPublisherLicence
Connector0.1.0ZAITRACKApache-2.0

What it does​

Planned: ZAITRACK does not connect to Komatsu Komtrax yet. Nothing is installed or run until it does.

  • Regions: JP, US, EU, AU, AE, SA, CL, CN
  • Capabilities: integration.fleet.telemetry, integration.fleet.maintenance, integration.fleet.fuel, integration.fleet.alerts, integration.fleet.smr

How to use it​

Not yet: see its status above.

Configuration​

SettingTypeRequiredAllowed values and default
customer_idstringyes—
tierenumyesone of soap_v3, rest_plus_v4; default "soap_v3"
soap_urlstringno—
rest_urlstringno—
sync_interval_sintegernofrom 300 to 86400; default 3600
asset_kindsarrayno—

Credentials​

Each is a secret setting of the installation: kept sealed (OpenBao in production), never shown again; Adapter Studio shows it as set.

  • komtrax_username
  • komtrax_password
  • komtrax_api_key
  • komtrax_customer_id

The maker's documentation: https://www.komatsu.com/en/-/media/home/komtrax/

Limits​

  • Memory: 256 MB
  • Time per call: 60,000 ms
  • Largest message: 4,194,304 bytes
  • Calls at once: 8
  • Network: only ws.komtrax.komatsu.com, api.komtrax.komatsu.com, komtraxplus.komatsu.com
  • Its own key-value store: up to 50,000 keys of 65,536 bytes

Troubleshooting​

  • Credentials refused. The secret settings must be the ones the provider issued for this account and environment (sandbox or live); give them again in Adapter Studio, since they are never shown back.
  • Rate limited. The provider's limit applies to the account: calls are retried with a growing pause; spread scheduled work or ask the provider for a higher limit.
  • Nothing is sent or synced. The installation must be active, its version approved; it reaches only the hosts listed under Limits.
  • Webhooks rejected. The webhook secret must match the one configured at the provider; a request whose signature does not match is refused.

Source​

adapters/connectors/komtrax