Skip to content
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions docs/throughput-collection.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
From version 5.4.0 we have introduce a new feature to collect usage data as part of the Platform.
Comment thread
johnsimons marked this conversation as resolved.
Outdated

Usage data is collected from 3 different sources:
- Audited messages
- Monitoring metrics
Comment thread
johnsimons marked this conversation as resolved.
Outdated
- Directly from the broker

The error instance is the orchestrator for all the collection from all these different endpoints.
Comment thread
johnsimons marked this conversation as resolved.
Outdated

Audited messages usage is collected by querying the audit instances every so often.
Broker collection is also collected by querying the borker directly every 24 hours.
The monitoring metrics collection is collected by the metrics intance sending a direct message to a well known queue that by default is named "servicecontrol.throughput".
Comment thread
johnsimons marked this conversation as resolved.
Outdated


### Why is the "servicecontrol.throughput" queue hardcoded?
The TF that initially created this new feature decided that by hardcoding the queue name, it would be simpler for the customers to get started because they don't need to configure anything up front.
This was decided based on simplicity of upgrade vs maintanability.

### Why is the "servicecontrol.throughput" not a sub queue of the error instance?
Because this would mean customer would have to configure the sending endpoint (monitoring instance) with the name of this queue, which we wanted to avoid.
Comment thread
johnsimons marked this conversation as resolved.
Outdated

#### But we have SCMU, can't that make sure the queue names match?
SCMU is a Windows only tool, as well as, this would only work if they are installing all instances on the same machine.
Same reasons why, we do not configure the remote audit instances.

### Can the "servicecontrol.throughput" queue be renamed?
Yes, see https://docs.particular.net/servicecontrol/monitoring-instances/configuration#usage-reporting
Comment thread
johnsimons marked this conversation as resolved.
Outdated