IBM MQ İzleme

Şirket içi IBM MQ için izlemeyi etkinleştirme

lslpp -l |grep libc++.rte

Red Hat OpenShift kümesinde IBM MQ için izlemeyi etkinleştirme

IBM MQ Operator 2.2.0 ve sonraki sürümleri IBM MQ Tracing 'i yerel olarak destekler. Yerel destek almak için IBM MQ kuyruk yöneticisi taşıyıcı görüntüsü 9.3.1.0-r2 ya da sonraki sürümleri kullanın. Bir IBM Cloud Pak for Integration kümesinde ya da Red Hat OpenShift Container Platform kümesinde IBM MQ Operator 2.2.0 ya da sonraki sürümler kullanılarak devreye alınan kuyruk yöneticileri için izleme özelliğini etkinleştirmek için bkz. . IBM MQ İzleme, x86_64, ppc64leve s390x Kubernetes düğümlerinde Linux üzerinde desteklenir.

You also can use Instana AutoTrace WebHook to enable Instana IBM MQ Tracing for IBM MQ on an IBM Cloud Pak for Integration cluster or a Red Hat OpenShift cluster. IBM MQ kuyruk yöneticisi taşıyıcı görüntülerinin tüm sürümleri desteklenir. However, Instana AutoTrace WebHook supports only linux/amd64 Kubernetes nodes. Bir Red Hat OpenShift kümesinde ( IBM Cloud Pak for Integrationdahil) çalışan IBM MQ kapsayıcısı için izlemeyi etkinleştirme hakkında daha fazla bilgi için bkz. Instana AutoTrace WebHook.

IBM MQ ' nun şirket içi IBM MQ için yapılandırılması

IBM MQ Tracing for-şirket içi IBM MQ' yu yapılandırmak için aşağıdaki adımları tamamlayın.

1. exits64 dizinine gidin:

   • Linux ve AIXiçin /var/mqm/exits64 dizinine gidin.
   • Windows için C:\ProgramData\IBM\MQ\exits64 dizinine gidin.

2. mqtracingexit.conf dosyasını tüm kuyruk yöneticisi yönetim ortamları için ya da mqtracingexit_<QMNAME>.conf dosyasını belirli bir kuyruk yöneticisi için düzenleyin.

   # configuration for IBM MQ Tracing user exit
   LOG_LEVEL="info" #Log level: info, warn, error, debug
   SPAN_FORMAT="instana"
   MONITOR_LEVEL="normal" #MQ tracing level: normal, quiet, off, debug
   IBMMQ_DEST_MONITOR_LEVEL_OFF = "" Regex for message destinations with tracing level off, for example: "^TMPQ.*". An example for multiple conditions: "^SYSTEM\\.AUTH\\..*|^TEMP\\.QUEUE\\..*".
   IBMMQ_DEST_MONITOR_LEVEL_QUIET = "" #Regex for message destinations with tracing level quiet
   IBMMQ_DEST_MONITOR_LEVEL_NORMAL = "" #Regex for message destinations with tracing level normal 
   IBMMQ_DEST_MONITOR_LEVEL_DEBUG = "" #Regex for message destinations with tracing level debug
   IBMMQ_PUBSUB_SUPPORT = "off" #The switch for the publish/subscribe support: on, off
   IBMMQ_RFH2_HEADERS_TO_EXPOSE = "" #A list of message headers that must be included in the `PUT` span payload, and each header is separated by commas.
   INSTANA_AGENT_HOST = "localhost" #(optional)
   INSTANA_AGENT_PORT = 42699 #(optional)
   INSTANA_AGENT_PROTO = "http" #(optional)
   HOST_ALIAS="<YOUR-HOST-NAME>" #(optional)
   

   Değişken açıklamaları:

   • LOG_LEVEL
     Bu parametre günlük düzeyini belirtir. Günlük düzeyi info, warn, errorya da debugolabilir. Linux ve AIXüzerinde, günlük dosyaları /tmp/ibmmqtrace dizininde ve Windows 'ta günlük dosyaları C:\ProgramData\IBM\MQ\trace dizininde bulunur. Günlük dosyalarının varsayılan dizinini değiştirmek için IBM MQ İzleme için günlük dosyaları bölümündeki adımlara bakın.
   • SPAN_FORMAT
     Bu parametre, aralık verilerinin gönderildiği izleme sistemini belirtir. Bu değişkeni instanaolarak ayarlayın. Varsayılan olarak, IBM MQ İzlenen kullanıcı çıkışı, anasistem aracısı uç noktasına yayılı veri gönderir http://localhost:42699. HTTPS iletişim kuralını kullanarak uzak anasistem aracısına aralık verilerini göndermek için INSTANA_AGENT_HOST ve INSTANA_AGENT_PROTOyapılandırma öğelerini güncelleyin. SPAN_FORMAT ayarı, IBM MQ anasistemleri için aynı olmalıdır.
   • MONITOR_LEVEL
     Bu parametre, off, quiet, normalya da debugolarak ayarlanabilen kuyruk yöneticilerinin varsayılan izleme düzeyini belirtir. MONITOR_LEVEL offolarak ayarlanırsa, izleme verileri toplanmaz. quietolarak ayarlanırsa, izleme ilintisi bilgileri tüm iletilere eklenmez, ancak iletiler IBM MQ sunucusunda izlenmeye devam edebilir. normalolarak ayarlanırsa, izleme ilintisi bilgileri iletilere RFH2 üstbilgileri ya da adlandırılmış özellikleriyle eklenir, ancak metin iletilerine eklenmez. debugolarak ayarlanırsa, izleme ilintisi bilgileri izlenmekte olan tüm iletilere eklenir.
   • IBMMQ_DEST_MONITOR_LEVEL_OFF
     Bu parametre, izleme düzeyi offolan ileti hedeflerini belirtir. Bu parametrenin değeri, "^TMPQ.*"gibi bir düzenli ifade olmalıdır. Bu, TMPQ ile başlayan hedeflere gönderilen iletilerin izlenmediği anlamına gelir. Hareketin bütünlüğünü sağlamak için, aynı ileti zincirindeki ileti hedefleri için aynı izleme düzeyini korumalısınız. Bir ileti hedefi birden çok düzenli ifadeyle eşleşiyorsa, geçerli düzenli ifadelerin öncelik sırası şöyledir: IBMMQ_DEST_MONITOR_LEVEL_OFF, IBMMQ_DEST_MONITOR_LEVEL_QUIET, IBMMQ_DEST_MONITOR_LEVEL_NORMALve IBMMQ_DEST_MONITOR_LEVEL_DEBUG.
   • IBMMQ_DEST_MONITOR_LEVEL_QUIET
     Bu parametre, izleme düzeyi quietolan ileti hedeflerini belirtir. Bu parametrenin değeri bir düzenli ifade olmalıdır. Bir ileti hedefi bu düzenli ifadeyle eşleşirse, izleme ilintisi bilgileri ileti hedefine gönderilen tüm iletilere eklenmez. Ancak, IBM MQ sunucusundaki iletileri izlemeye devam edebilirsiniz.
   • IBMMQ_DEST_MONITOR_LEVEL_NORMAL
     Bu parametre, izleme düzeyi normalolan ileti hedeflerini belirtir. Bu parametrenin değeri bir düzenli ifade olmalıdır. İleti hedefi bu düzenli ifadeyle eşleşirse, izleme ilintisi bilgileri RFH2 üstbilgileri ya da adlandırılmış özellikleri olan iletilere eklenir. Ancak, izleme ilintisi bilgileri metin iletilerine eklenmez.
   • IBMMQ_DEST_MONITOR_LEVEL_DEBUG
     Bu parametre, izleme düzeyi debugolan ileti hedeflerini belirtir. Bu parametrenin değeri bir düzenli ifade olmalıdır. İleti hedefi bu düzenli ifadeyle eşleşirse, izleme ilintisi bilgileri ileti hedefine gönderilen tüm iletilere eklenir.
   • IBMMQ_PUBSUB_SUPPORT
     Bu parametre, izleme yayınlama ve abone olma iletilerinin etkinleştirilip etkinleştirilmeyeceğini denetler. Etkinleştirmek için on ve desteği devre dışı bırakmak için off olarak ayarlayın.
   • IBMMQ_RFH2_HEADERS_TO_EXPOSE
     Bu değiştirge, kapsam bilgi yüküne eklenmesi gereken ileti üstbilgilerinin bir listesini belirtir ve her üstbilgi virgülle ayrılır; örneğin, IBMMQ_RFH2_HEADERS_TO_EXPOSE="rfh2_folder1.header1, rfh2_folder2.header2, header3". 256 byte 'tan büyük bir boyuta sahip ileti üstbilgisinin kesilmesi, çok büyük bir aralık büyüklüğü yaratılmasını önler ve genel başarımı etkiler. Ayrıca, bir aralıktaki tüm toplanan ileti üstbilgilerinin toplam uzunluğu 3 KB ' yi aşmamalıdır. Bu nedenle, kaynak grubu için yalnızca en önemli üstbilgiler yapılandırılmalıdır.
   • INSTANA_AGENT_HOST
     Bu değiştirge, YönOrtamıana biçim kapsamı verilerinin gönderildiği aracı anasistemini ve varsayılan olarak localhost 'u belirtir. Bir uzak aracı anasistemi belirtirseniz, anasistem aracısına varsayılan olarak diğer anasistemlerden ulaşılamadığı için, önce uzak anasistem aracısı için http.listen=* satırını <instana-agent-dir>/etc/instana/com.instana.agent.main.config.Agent.cfg içine eklemeniz gerekir.
   • INSTANA_AGENT_PORT
     Bu değiştirge, YönOrtamıaracı 'nın dinlediği kapıyı belirtir ve 42699 varsayılan olarak kullanılır. Kapıyı yalnızca aracı başka bir kapıda dinlerken değiştirmeniz gerekir.
   • INSTANA_AGENT_PROTO
     Bu değiştirge, IBM MQ İzleme çıkışı ile anasistem aracısı arasındaki bağlantı tipini belirtir. IBM MQ algılayıcısı hem HTTP hem de HTTPS iletişim kurallarını destekler. Ancak varsayılan olarak HTTP kullanılır. İletişim kuralını HTTPS olarak değiştirmek için öncelikle aracı uç noktasının güvenliğini sağlamanız gerekir. Aracı uç noktasının nasıl güvenli hale getirdiğine ilişkin daha fazla bilgi için Aracı uç noktası için TLS şifrelemesini ayarlamabaşlıklı konuya bakın.
   • HOST_ALIAS
     Bu değiştirge, IBM MQ İzleyen kullanıcı çıkışı tarafından toplanan aralık verilerine ilişkin bir anasistem diğer adını belirtir. IBM MQ algılayıcısı kuyruk yöneticisini de izliyorsa, aramaları IBM MQ ile altyapı varlığına bağlayabilirsiniz. MQ anasisteminin FQDN 'si varsayılan olarak kullanılır. Anasistem diğer adı değerinin, anasistem aracısı yapılandırma yaml 'de belirtilen IBM MQ anasistemiyle eşleşmesi gerekir. IBM MQ anasisteminin FQDN 'si IBM MQ algılayıcı yapılandırmasında kullanılmıyorsa ve anasistem aracısı yerel IBM MQ anasisteminde değilse, bir anasistem diğer adı belirtin. IBM MQ algılayıcısı, yerel kuyruk yöneticisi eşgörünümlerine ilişkin FQDN ' yi keşfedebilir.

3. Dosyayı kaydedin.

4. Kuyruk yöneticisi yönetim ortamlarını yeniden başlatın.

Not: Instana 246 ve sonraki sürümler, IBM MQ İzleme kullanıcı çıkışı için özel bir hizmet adı ayarlanmasını destekler. Özel bir hizmet adı ayarlamak için, IBM MQ süreçleri için INSTANA_SERVICE_NAME ortam değişkenini ayarlayın.

Bir Red Hat OpenShift kümesinde IBM MQ İzlemesini Yapılandırma

Red Hat OpenShift kümesinde çalışan bir kuyruk yöneticisi için IBM MQ İzleme yapılandırmasını değiştirmek üzere kuyruk yöneticisi bölmesine yeni ortam değişkenleri ekleyin. Ortam değişkeni adı, Yapılandırma IBM MQ Şirket içi IBM MQ bölümünde listelenen yapılandırma öğesi adıyla eşleşmelidir. Bir kuyruk yöneticisi bölmesine ilişkin ortam değişkeni eklemek için aşağıdaki adımları izleyin:

1. Red Hat OpenShift küme web konsolunuzda oturum açın.

2. Gezinme panosunda İşleçler > Kurulu İşleçlerseçeneklerini tıklatın. Belirtilen projedeki kurulu tüm Operatörler görüntülenir.

3. IBM MQ İşleciseçeneğini belirleyin. IBM MQ İşletmen penceresi görüntülenir.

4. Kuyruk yöneticisi sekmesine gidin. Kuyruk yöneticisi Ayrıntıları penceresi görüntülenir.

5. İzleme yapılanışını değiştirmek istediğiniz kuyruk yöneticisini seçin.

6. YAML sekmesine gidin.

7. spec > template > pod > containers > env bölümüne ortam değişkenini ekleyin. Örneğin, hata ayıklamak için IBM MQ İzleme günlük düzeyini değiştirmek üzere aşağıdaki parçacığı kullanın:

   template:
    pod:
      containers:
        - env:
            - name: LOG_LEVEL
              value: debug
   

8. Güncellenen kuyruk yöneticisi YAML dosyasını kaydedin.

Upgrading IBM MQ Tracing for-şirket içi IBM MQ on Linux ya da AIX

1. Kuyruk yöneticisi yönetim ortamlarını durdurun.
2. IBM MQ sunucusundaki /var/mqm/exits64 dizininde IBM MQ Tracing user exit için yapılandırma dosyalarını yedekleyin.
3. Karşıdan yüklenen IBM MQ Tracing kullanıcı çıkış dosyasını çıkarın ve /var/mqm/exits64 dizinindeki ilgili dosyaları değiştirin.
4. Kuyruk yöneticisi yönetim ortamlarını başlatın.

Upgrading IBM MQ Tracing for-şirket içi IBM MQ on Windows

1. Kuyruk yöneticisi yönetim ortamlarını durdurun.
2. IBM MQ sunucusundaki C:\ProgramData\IBM\MQ\exits64 dizininde IBM MQ Tracing user exit için yapılandırma dosyalarını yedekleyin.
3. Karşıdan yüklenen IBM MQ İzleme kullanıcı çıkışı dosyasını açın ve C:\ProgramData\IBM\MQ\exits64 dizinindeki ilgili dosyaları değiştirin.
4. Kuyruk yöneticisi yönetim ortamlarını başlatın.

Bir Red Hat OpenShift kümesinde IBM MQ İzlemesini Yükseltme

Bir Red Hat OpenShift kümesinde IBM MQ İzleme 'yi yükseltmek için aşağıdaki adımlardan birini gerçekleştirin:

• IBM MQ İzleme IBM MQ Operator 2.2.0 ya da sonraki sürümleri kullanılarak etkinleştirildiyse, IBM MQ kuyruk yöneticisini yükseltin.
• IBM MQ İzleme AutoTrace WebHookkullanılarak etkinleştirildiyse, YönOrtamıAna AutoTrace WebHook ' yı yeniden konuşlandırın ve kuyruk yöneticisi bölmesini yeniden başlatın.

IBM MQ ' nun şirket içi IBM MQ için izlenmesini devre dışı bırakma

IBM MQ' da izleme verilerinin toplanmasını geçersiz kılmak için, mqtracingexit.con dosyasında MONITOR_LEVEL değerini off olarak ayarlayın.

IBM MQ İzleyen kullanıcı çıkışını devre dışı bırakmak için IBM MQ anasistemlerinde aşağıdaki adımları tamamlayın:

1. /var/mqm/mqs.ini ya da C:\ProgramData\IBM\MQ\mqs.ini dosyasında yapılandırdığınız ApiExitCommon ve ApiExitLocal bölümünü kaldırın ve /var/mqm/qmgrs/<QMNAME>/qm.ini ya da C:\ProgramData\IBM\MQ\qmgrs\<QMNAME>\qm.ini dosyasını, IBM MQ İzlemesi 'nin etkinleştirildiği IBM MQ anasistemlerinden kaldırın.
2. Kuyruk yöneticisi yönetim ortamlarını yeniden başlatın.

Bir Red Hat OpenShift kümesinde IBM MQ İzlemesini Devre Dışı Bırakma

Bir Red Hat OpenShift kümesinde IBM MQ İzleme özelliğini devre dışı bırakmak için aşağıdaki adımlardan birini gerçekleştirin:

• IBM MQ Tracing IBM MQ Operator version 2.2.0 ya da sonraki bir sürümü kullanılarak etkinleştirildiyse, IBM Cloud Pak for Integration Platform UI ya da OpenShift web konsolunda Enable Instana tracing açma/kapama özelliğini false olarak ayarlayın. IBM MQ kılavuzunabakın.
• IBM MQ İzlemesi AutoTrace WebHookkullanılarak etkinleştirildiyse, aşağıdaki adımlardan birini gerçekleştirin:
  • Instana AutoTrace WebHook(Otomatik İzleme) olanağını kaldırın ve kuyruk mananger kapsüllerini yeniden başlatın.
  • Instana AutoTrace WebHook'ı kaldırın, autotrace.ibmmq.enabled ' i falseolarak ayarlayın ve YönOrtamıza AutoTrace WebHook ' ı yeniden konuşlandırın. Değişikliklerin yürürlüğe girmesi için kuyruk yöneticisi bölmesini yeniden başlatın. Bkz. Instana AutoTrace WebHook kılavuzu.

Ek MQRFH2 üstbilgilerinin neden olduğu ileti işleme hatası

İzleme ilintisi bilgilerini yaymak için, IBM MQ İzleme kullanıcı çıkışı, iletiler zaten MQRFH2 üstbilgilerini içerdiğinde ya da ileti hedefinin izleyici düzeyi debugolarak ayarlandığında izlenmekte olan iletilere ek MQRFH2 üstbilgileri (X_INSTANA_T, X_INSTANA_S, X_INSTANA_L, traceparentve tracestate) ekler. Ancak iletilerde ek üstbilgi verilerinin bulunması, bazı IBM MQ tüketici uygulamalarında ileti işleme hatalarına ve iletilerin reddedilmesine neden olabilir. Ek MQRFH2 üstbilgileri bir IBM MQ istemci uygulamasında hatalara neden olursa, aşağıdaki işlemlerden birini gerçekleştirin:

• IBM MQ istemci uygulamasını, YönOrtamı'nıın eklediği izleme ilintilendirme bilgileriyle birlikte ek MQRFH2 üstbilgilerini yoksayacak şekilde değiştirin.
• İleti alışverişi zincirindeki kuyrukları IBM MQ İzleniyor kullanıcı çıkışı yapılanış değiştirgesi IBMMQ_DEST_MONITOR_LEVEL_QUIET' ne ekleyerek izleme ilintisi yayılımını geçersiz kılın.
• IBM MQ istemci uygulaması tarafından bağlanan kuyruk için PROPCTL özelliğinin değerini NONE olarak değiştirin.

İzleme ilintisi bilgileri IBM MQ iletilerine eklenmez

Varsayılan olarak izleme ilintisi bilgileri, MQRFH2 üstbilgilerini ya da ileti özelliklerini içeren IBM MQ iletilerine otomatik olarak eklenir. IBM MQ istemci uygulamalarınızın bozulmasını önlemek için, IBM MQ İzleme kullanıcı çıkışı, düz metin iletilerine izleme ilintilendirme bilgileri eklemez. Yine de iletilere izleme ilintisi bilgilerini eklemek istiyorsanız, ileti hedeflerini IBM MQ İzleme kullanıcı çıkışı yapılanış değiştirgesi IBMMQ_DEST_MONITOR_LEVEL_DEBUG' ne ekleyebilirsiniz. Ancak, IBM MQ istemci uygulamanızın iletileri ek MQRFH2 üstbilgileriyle ayrıştırabildiğinden emin olmanız gerekir.

Altyapı bağlantısı arama ayrıntılarında görüntülenmez

IBM MQ İzleme kullanıcı çıkışı tarafından oluşturulan bir çağrıyı, YönOrtamıAna Kullanıcı Arabirimindeki IBM MQ algılayıcısı tarafından toplanan IBM MQ kuyruk yöneticisinin izlenen bir altyapı varlığına bağlayabilirsiniz. IBM MQ algılayıcısı tarafından toplanan bir kuyruk yöneticisinin varlık tanıtıcısı hem etkin hem de yedek IBM MQ düğümlerinin anasistemini içerdiğinden, altyapı bağlantısı IBM MQ yüksek kullanılabilirlik senaryolarında kullanılamayabilir. Bu, yalnızca etkin IBM MQ düğümünün anasistemini içeren IBM MQ İzleme kullanıcı çıkışı tarafından oluşturulan varlık tanıtıcısıyla çelişir. Yanlış eşleşme, çağrı ayrıntıları ile kuyruk varlığı arasındaki bağlantıyı bozar. Bu sorunu çözmek için aşağıdaki işlemleri gerçekleştirebilirsiniz:

1. Instana kullanıcı arabirimindeki Altyapı görünümündeki yüksek kullanılabilirlikli kuyruk yöneticisi gösterge panosuna gidin.
2. Kuyruk yöneticisi anasistem bilgilerini almak için kuyruk yöneticisi gösterge panosunun kenar çubuğunda Ad özniteliğini bulun. Yüksek kullanılabilirlikli kuyruk yöneticisinin anasistemi, Name dizgisinin @ simgesinden sonra gelen bölümüdür. Örneğin, kuyruk yöneticisi adı "haqm1@ibmmqnode1.ibm.com-ibmmqnode2.ibm.com-ibmmqnode3.ibm.com" olarak görünüyorsa, kuyruk yöneticisi anasistemi "ibmmqnode1.ibm.com-ibmmqnode2.ibm.com-ibmmqnode3.ibm.com" olur.
3. IBM MQ sunucusuna erişin ve IBM MQ İzleme kullanıcı çıkışı için mqtracingexit.conf yapılandırma dosyasını açın.
4. HOST_ALIAS alanını, 2. adımda alınan kuyruk yöneticisi anasistem adına ayarlayın.
5. Yapılandırma dosyasını kaydedin.
6. Değişiklikleri uygulamak için yüksek kullanılabilirlikli kuyruk yöneticisini yeniden başlatın.