Glossary

Last updated: 2020-07-14 14:34:26

    Long Polling

    Long polling refers to a mechanism where when the client sends a request to the server, the server will hold the connection when receiving the request and return a response message and close the connection until a new message arrives, and the client will send a new request to the server after processing the response message.
    A message consumption request will return a response only after a valid message is fetched or the long-polling time elapses, which can avoid repeated invalid polling.

    Retry Policy

    Retry policy refers to the NotifyStrategy attribute of a subscription in CMQ, i.e., the policy used to perform retry when an error occurs during message push to receivers.
    The retry policy is enabled by default, and you must select one of the following two options:

    • Backoff retry: an attempt will be retried three times at random intervals between 10 and 20 seconds. After three retries, the message will be discarded for the subscriber and will not be retried again.
    • Exponential decay retry: an attempt will be retried 176 times for one day at exponentially increasing intervals: 2^0 seconds, 2^1 seconds, ..., 512 seconds, 512 seconds, ..., 512 seconds. This is the default retry policy.

    CMQ

    For more information, please see Cloud Message Queue.

    Subscriber

    A subscriber refers to a subscriber to a service in topic mode in CMQ.

    Queue

    • In GSE, a queue is a group of server fleets running in regions of a game asset package. You can use a queue to create a cross-region fleet group and allows placing game server sessions in any fleet in the queue, so as to minimize the delay, deliver a better player experience, use more fleet capacity more efficiently, provide high capacity for new games more swiftly, and make the game more elastically available.
    • In CMQ, a queue is the destination of message storage, from which consumers actively get messages. In a queue, MessageId or ReceiptHandle is used to uniquely identify messages.

    Polling Wait Time

    Polling wait time (PollingWaitSeconds) refers to the maximum wait time for a polling to time out in seconds. Its value ranges from 0 to 30 seconds.

    Request

    A request refers to the content sent by a consumer to a queue in order to get a message.

    Hidden Duration of Fetched Message

    Hidden duration of fetched message (VisibilityTimeout) refers to the duration after which a message will be sent to and processed by another process if it fails to be processed after being received. It will be counted in seconds immediately after a message is received, and its value ranges from 1 second to 43,200 seconds (i.e., 1 second–12 hours).

    Production

    Production (Produce) refers to an operation of writing a message into a topic by a CMQ producer.

    Producer

    A producer refers to a role that sends messages in CMQ.

    Dead Letter Queue

    A dead letter queue (DeadLetterQueue) is used to process messages that fail to be processed properly. After it is enabled, undeleted messages whose times of consumptions exceeds the limit and expired messages will be delivered to the dead letter queue according to corresponding rules.

    Consumer

    A consumer refers to a role that receives messages in CMQ.

    Message

    A message refers to the content delivered between different processes in CMQ, which contains data and attributes.

    Message ID

    A message ID is a message's unique identifier used to differentiate it from other messages. Each message will receive a message ID assigned by the Tencent Cloud system, which can be returned to you through the SendMessage API request.

    Message Retention

    Message retention (MessageRetentionPeriod) refers to a process where messages that are produced by a producer but have not triggered delivery to subscribers or failed to be received by subscribers will be retained in the topic temporarily and be delivered again for multiple times. It is enabled by default and is not configurable. The maximum retention period is 1 day.

    Cloud Message Queue

    Tencent Cloud Message Queue (CMQ) is a distributed message queue service that provides a reliable message-based async communication mechanism. It enables message receiving/sending among different applications deployed in a distributed manner (or different components of the same application) and stores the messages in reliable and valid CMQ queues to prevent message loss. It supports multi-process simultaneous read/write, so that message sending and receiving do not interfere with each other, eliminating the need for the applications or components to keep running.

    Message Receipt Mode

    Message receipt mode (Message-receiving model) refers to the method for a consumer to get messages. Currently, only the pull mode is supported, that is, the consumer actively gets messages.

    Message Handler

    A message handler (ReceiptHandle) marks a message as manipulatable. Every time you read a message from a message receipt queue, you will receive a handler (Handle) that can be used to manipulate the message at the same time.
    You can use a message handler to delete or modify some attributes of a message. It is relevant to the message receipt operation rather than the message itself. To delete or modify a message, the message handler instead of the message ID must be provided, which means that a message can be modified/deleted only after it is received.
    Message handlers provided by CMQ have a validity period and will expire after the preset duration (which is 30 seconds by default and can be customized) elapses. This effectively avoids faulty data operations and greatly reduces the risks that may be caused by handler disclosure.

    Message Content

    Message content (Message Body) refers to the received message body. The default encoding format of messages received and sent in Tencent Cloud is Base64, which is the same as that of the official SDK of Message Service.

    Message Lifecycle

    Message lifecycle (msgRetentionSeconds) refers to the maximum period of time during which a message can be retained. After the period specified by this parameter has elapsed since a message is sent to the queue, the message will be deleted no matter whether it has been fetched. It is measured in seconds.

    • In a queue, its value ranges from 60 to 1,296,000 seconds (i.e., 1 minute–15 days).
    • In a topic, it is 86,400 seconds (1 day) by default and cannot be modified.

    First Consumption Time of Message

    The first consumption time of a message (FirstDequeueTime) refers to the time when a message in a queue is consumed for the first time.

    Next Consumption Time of Message

    The next consumption time of a message (NextVisibleTime) refers to the time when a received message can be consumed again.

    Message Consumption Count

    Message consumption count (DequeueCount) refers to the total number of times that a message is consumed in a queue.

    Message Digest

    Message digest (MsgBodyMD5) is a fixed-length value uniquely corresponding to a message or piece of text, which is used to check whether the information is tampered with during consumption.

    Maximum Message Length

    Maximum message length (MaxMsgSize) refers to the maximum length of a message body that can be sent to a queue. It is measured in bytes and ranges from 1,024 to 65,536 bytes (i.e., 1–64 KB).

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help