-
Notifications
You must be signed in to change notification settings - Fork 33
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Feature/mtm 58268/document mqtt service topic limiting #2464
base: private-preview/mqtt-connect
Are you sure you want to change the base?
Feature/mtm 58268/document mqtt service topic limiting #2464
Conversation
…nd expected behaviour when exceeding limit
Preview available here |
@@ -40,6 +40,29 @@ Other than that you are free to use any topic name which is compatible with the | |||
Wildcard topics (`+`, `#`) and system topics starting with `$` are not supported. | |||
{{< /c8y-admon-info >}} | |||
|
|||
#### Topic limit {#topic-limit} | |||
|
|||
MQTT Service has the ability to limit the total number of topics that a single tenant can create, current default is no limit. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
MQTT Service has the ability to limit the total number of topics that a single tenant can create, current default is no limit. | |
MQTT Service has the ability to limit the total number of topics that a single tenant can create. The current default is no limit. |
content/device-integration/mqtt-service-bundle/implementation.md
Outdated
Show resolved
Hide resolved
content/device-integration/mqtt-service-bundle/implementation.md
Outdated
Show resolved
Hide resolved
the delivery of the packet is prevented. | ||
|
||
In the case of MQTT 5 clients have access to reason code and reason string describing the failure when using QoS 1 via acknowledgements, | ||
reason code being QUOTA_EXCEEDED: 0x97. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
reason code being QUOTA_EXCEEDED: 0x97. | |
reason code being `QUOTA_EXCEEDED: 0x97`. |
|
||
In the case of MQTT 5 clients have access to reason code and reason string describing the failure when using QoS 1 via acknowledgements, | ||
reason code being QUOTA_EXCEEDED: 0x97. | ||
In the case of MQTT 3.1 and 3.1.1 clients only have access to reason code describing the failure when using QoS 1 via acknowledgements and only |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
In the case of MQTT 3.1 and 3.1.1 clients only have access to reason code describing the failure when using QoS 1 via acknowledgements and only | |
In the case of MQTT 3.1 and 3.1.1 clients only have access to the reason code describing the failure when using QoS 1 via acknowledgements and only |
In the case of MQTT 5 clients have access to reason code and reason string describing the failure when using QoS 1 via acknowledgements, | ||
reason code being QUOTA_EXCEEDED: 0x97. | ||
In the case of MQTT 3.1 and 3.1.1 clients only have access to reason code describing the failure when using QoS 1 via acknowledgements and only | ||
for SUBSCRIBE packets, where the reason code is 0x80. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
for SUBSCRIBE packets, where the reason code is 0x80. | |
for the SUBSCRIBE packets, where the reason code is `0x80`. |
reason code being QUOTA_EXCEEDED: 0x97. | ||
In the case of MQTT 3.1 and 3.1.1 clients only have access to reason code describing the failure when using QoS 1 via acknowledgements and only | ||
for SUBSCRIBE packets, where the reason code is 0x80. | ||
For PUBLISH packets, client will be disconnected with no further information as per the MQTT specification. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
For PUBLISH packets, client will be disconnected with no further information as per the MQTT specification. | |
For PUBLISH packets, the client will be disconnected with no further information as per the MQTT specification. |
content/device-integration/mqtt-service-bundle/implementation.md
Outdated
Show resolved
Hide resolved
#### Topic cleanup {#topic-cleanup} | ||
|
||
MQTT Service will automatically remove topics which are no longer in use, topics are recognized as inactive when there are no subscriptions and | ||
internal publisher to the topic is closed. The publisher is responsible for publishing modified MQTT Service messages to the correct topic and these |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
internal publisher to the topic is closed. The publisher is responsible for publishing modified MQTT Service messages to the correct topic and these | |
the internal publisher to the topic is closed. The publisher is responsible for publishing the modified MQTT service messages to the correct topic. These |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Alternative that adds this below. 'These sounded like the messages as it was the only plural entity in the previous sentence, so below I've changed 'These' to 'The publishers' to be clearer. I also improved the following sentence
@@ -1,4 +1,4 @@ | |||
--- | |||
title: Introduction | |||
title: MQTT Service |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
title: MQTT Service | |
title: MQTT service |
content/device-integration/mqtt-service-bundle/implementation.md
Outdated
Show resolved
Hide resolved
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Happy to go through these with you (it might be confusing given I've added to @MWindel's comments. Also I might need correction to my understanding.
Additional sections outlining changes included in MQTT Service topic limiting feature.
Details regarding receiving errors for topic limit related failures for MQTT 3 clients via error topic are absent as this is yet to be implemented: https://github.com/Cumulocity-IoT/c8y-mqtt-service/pull/153