Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Error code

Reason

Client action

..AuthorizationFailed

Client is not permitted to send metrics.

Log a warning to the application and schedule the next GetTelemetrySubscriptionsRequest in 30 minutes.

InvalidRecord

Broker failed to decode or validate the client’s encoded metrics.

Log a warning to the application and schedule the next GetTelemetrySubscriptionsRequest to 5 minutes.

FunctionalityNotEnabled

Client sent a GetTelemetrySubscriptionsRequest to a broker which does not have a client metrics receiver plugin configured.

Log a warning to the application and schedule the next GetTelemetrySubscriptionsRequest in 30 minutes, preferably on another broker.

RateLimited

Client sent a non-Terminate push request before the NextPushMs time had expired.

The response will include only the NextPushMs which the client will use to adjust its next push time.

UnsupportedCompressionType

Client’s compression type is not supported by the broker.

The client should switch to another compression type. When all compression types are exhausted the application should fall back to uncompressed formatSend a GetTelemetrySubscriptionRequest to get an up to date list of the broker's supported compression types (and any subscription changes).

The 5 and 30 minute retries are to eventually trigger a retry and avoid having to restart clients if the cluster metrics configuration is disabled temporarily, e.g., by operator error.

...