OnsTraceGetResult - - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

Bir mesajın izleme ayrıntılarını sorgulamak için bu işlemi çağırmadan önce, mesaj kimliği veya mesaj anahtarını kullanarak izleme sorgusu için bir görev oluşturmanız ve görev kimliğini almanız gerekir. Daha sonra, bu görev kimliğini kullanarak mesaj izleme ayrıntılarını sorgulamak üzere bu işlemi çağırabilirsiniz. Mesaj izleme sorgusu görevi oluşturmak ve görev kimliğini QueryId yanıt parametresinden almak için OnsTraceQueryByMsgId veya OnsTraceQueryByMsgKey işlemini çağırabilirsiniz.
İzleme sorgusu görevleri zaman alıcıdır. Bir izleme sorgusu görevi oluşturduktan hemen sonra bu işlemi çağırırsanız sonuçlar boş dönebilir. Bu durumda, daha sonra tekrar denemenizi öneririz.

İstek sınırı

Her Alibaba Cloud hesabı bu işlemi saniyede en fazla 10 kez çağırabilir. 1 saniye içinde bu işlem için gönderilen istek sayısı sınıra ulaştığında yeni istekler başarısız olur. Bu durum iş sürekliliğinizi kesintiye uğratabilir. Her işlemin istek sınırı hakkında bilgi edinmek için bkz. API hız sınırları.

Yetkilendirme

Varsayılan olarak bu işlemi yalnızca Alibaba Cloud hesapları çağırabilir. Bir Resource Access Management (RAM) kullanıcısı gerekli izinler verildikten sonra bu işlemi çağırabilir. Aşağıdaki tabloda, bu işlemi çağırmak için bir RAM kullanıcısına verilmesi gereken izinler açıklanmaktadır. İzinlerin nasıl verileceği hakkında bilgi edinmek için bkz. İlkeler ve örnekler.

API	Action	Resource
OnsTraceGetResult	mq:QueryInstanceBaseInfo	acs:mq:::{instanceId}

İstek parametreleri

Parameter	Type	Required	Example	Description
Action	String	Yes	OnsTraceGetResult	Gerçekleştirmek istediğiniz işlem. Değeri OnsTraceGetResult olarak ayarlayın.
QueryId	String	Yes	272967562652883649157096685****	Mesaj izlemesini sorgulamak için oluşturulan görevin kimliği.

Yanıt parametreleri

Parameter	Type	Example	Description
RequestId	String	84EE24D2-851F-40D6-B99E-4D6AB909****	İsteğin kimliği. Sistem her istek için benzersiz bir kimlik oluşturur. Sorun giderme işlemlerini istek kimliğine göre yürütebilirsiniz.
TraceData	Object		Mesaj izleme kaydının ayrıntıları.
Status	String	finish	Görevin durumu. Geçerli değerler: finish: Görev tamamlandı. working: Görev devam ediyor. removed: Görev silindi.
MsgKey	String	ORDERID_100	Sorgulanan mesajın anahtarı.
UpdateTime	Long	1570966877000	Görevin en son güncellendiği zaman damgası.
CreateTime	Long	1570966857000	Görevin oluşturulduğu zaman damgası.
Topic	String	test	Mesajın depolandığı konu.
UserId	String	27296756265288****	Görevi oluşturan kullanıcının kimliği.
InstanceId	String	MQ_INST_111111111111_DOxxxxxx	Mesajı içeren örneğin kimliği.
MsgId	String	1E05791C117818B4AAC23B1BB0CE****	Sorgulanan mesajın kimliği.
TraceList	Array of TraceMapDo		Mesaj izleme kaydının ayrıntıları.
TraceMapDo
Status	String	SEND_SUCCESS	Mesajın gönderilip gönderilmediğini belirtir. Geçerli değerler: SEND_SUCCESS: Mesaj gönderildi. SEND_FAILED: Mesaj gönderilemedi. SEND_ROLLBACK: Mesaj bir işlem mesajıdır ve geri alındı. SEND_UNKNOWN: Mesaj bir işlem mesajıdır ve commit edilmedi. SEND_DELAY: Mesaj zamanlanmış veya gecikmeli bir mesajdır ve belirtilen zamanda gönderilmek üzere beklemektedir.
MsgKey	String	ORDERID_100	Mesajın anahtarı.
PubTime	Long	1570850870478	Mesajın gönderildiği zaman damgası.
SubList	Array of SubMapDo		Mesajın tüketim izleme kayıtları.
SubMapDo
ClientList	Array of SubClientInfoDo		Gruptaki tüketiciler tarafından mesaj tüketimine ilişkin bilgiler.
SubClientInfoDo
Status	String	CONSUME_SUCCESS	Mesajın tüketilip tüketilmediğini belirtir. Geçerli değerler: CONSUME_FAILED: Mesaj tüketilemedi. CONSUME_SUCCESS: Mesaj tüketildi. CONSUME_NOT_RETURN: Yanıt döndürülmedi. SEND_UNKNOWN: Mesaj bir işlem mesajıdır ve commit edilmedi. SEND_DELAY: Mesaj zamanlanmış veya gecikmeli bir mesajdır ve belirtilen zamanda tüketilmek üzere beklemektedir.
SubTime	Long	1570851590511	Mesajın ilk tüketildiği zaman damgası.
ReconsumeTimes	Integer	1	Message Queue for Apache RocketMQ broker'ın mesajı tüketiciye göndermeyi deneme sayısı.
SubGroupName	String	GID_test	Tüketiciyi içeren grubun kimliği.
ClientHost	String	30.5..	Tüketicinin adresi.
CostTime	Integer	43	Sistemin mesajı tüketmesi için geçen süre. Birim: milisaniye.
FailCount	Integer	0	Tüketim hatalarının sayısı.
SubGroupName	String	GID_test	Tüketici grubunun kimliği.
SuccessCount	Integer	1	Başarılı tüketim sayısı.
Topic	String	test	Mesajın depolandığı konu.
CostTime	Integer	24	Sistemin mesajı göndermesi için geçen süre. Birim: milisaniye.
Tag	String	TagA	Mesajın etiketi.
MsgId	String	0BC1F01800002A9F000000531246****	Mesajın kimliği.
PubGroupName	String	GID_test	Üreticiyi içeren grubun kimliği.
BornHost	String	30.5..	Mesajı oluşturan üreticinin adresi.
QueryId	String	272967562652883649157096685****	Görevin kimliği.

Örnekler

Örnek istekler

http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsTraceGetResult
&QueryId=272967562652883649157096685****
&<Common request parameters>

Örnek başarılı yanıtlar

XML biçimi

HTTP/1.1 200 OK
Content-Type:application/xml

<OnsTraceGetResultResponse>
<TraceData>
    <MsgId>1E05791C117818B4AAC23B1BB0CE****</MsgId>
    <Status>finish</Status>
    <TraceList>
        <TraceMapDo>
            <BornHost>30.5.**.**</BornHost>
            <MsgId>0BC1F01800002A9F000000531246****</MsgId>
            <Status>SEND_SUCCESS</Status>
            <CostTime>24</CostTime>
            <PubTime>1570850870478</PubTime>
            <Tag>TagA</Tag>
            <Topic>test</Topic>
            <MsgKey>ORDERID_100</MsgKey>
            <PubGroupName>GID_test</PubGroupName>
            <SubList>
                <SubMapDo>
                    <ClientList>
                        <SubClientInfoDo>
                            <Status>CONSUME_SUCCESS</Status>
                            <CostTime>43</CostTime>
                            <ClientHost>30.5.**.**</ClientHost>
                            <ReconsumeTimes>1</ReconsumeTimes>
                            <SubTime>1570851590511</SubTime>
                            <SubGroupName>GID_test</SubGroupName>
                        </SubClientInfoDo>
                    </ClientList>
                    <SuccessCount>1</SuccessCount>
                    <FailCount>0</FailCount>
                    <SubGroupName>GID_test</SubGroupName>
                </SubMapDo>
            </SubList>
        </TraceMapDo>
    </TraceList>
    <CreateTime>1570966857000</CreateTime>
    <InstanceId>MQ_INST_111111111111_DOxxxxxx</InstanceId>
    <Topic>test</Topic>
    <UpdateTime>1570966877000</UpdateTime>
    <QueryId>272967562652883649157096685****</QueryId>
    <UserId>27296756265288****</UserId>
</TraceData>
<RequestId>84EE24D2-851F-40D6-B99E-4D6AB909****</RequestId>
</OnsTraceGetResultResponse>

JSON biçimi

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TraceData" : {
    "MsgId" : "1E05791C117818B4AAC23B1BB0CE****",
    "Status" : "finish",
    "TraceList" : {
      "TraceMapDo" : [ {
        "BornHost" : "30.5.**.**",
        "MsgId" : "0BC1F01800002A9F000000531246****",
        "Status" : "SEND_SUCCESS",
        "CostTime" : 24,
        "PubTime" : 1570850870478,
        "Tag" : "TagA",
        "Topic" : "test",
        "MsgKey" : "ORDERID_100",
        "PubGroupName" : "GID_test",
        "SubList" : {
          "SubMapDo" : [ {
            "ClientList" : {
              "SubClientInfoDo" : [ {
                "Status" : "CONSUME_SUCCESS",
                "CostTime" : 43,
                "ClientHost" : "30.5.**.**",
                "ReconsumeTimes" : 1,
                "SubTime" : 1570851590511,
                "SubGroupName" : "GID_test"
              } ]
            },
            "SuccessCount" : 1,
            "FailCount" : 0,
            "SubGroupName" : "GID_test"
          } ]
        }
      } ]
    },
    "CreateTime" : 1570966857000,
    "InstanceId" : "MQ_INST_111111111111_DOxxxxxx",
    "Topic" : "test",
    "UpdateTime" : 1570966877000,
    "QueryId" : "272967562652883649157096685****",
    "UserId" : "27296756265288****"
  },
  "RequestId" : "84EE24D2-851F-40D6-B99E-4D6AB909****"
}

Hata kodları

Hata kodlarının listesi için API Error Center adresini ziyaret edin.

Konsolda mesaj izleme kaydını sorgulama

Mesaj izleme kaydını Message Queue for Apache RocketMQ console üzerinden de sorgulayabilirsiniz. Daha fazla bilgi için bkz. Mesaj izleme kaydını sorgulama.