ARM 應用程式內容和交易環境定義資料

要求度量提供內建的檢測來監視交易流程。 要求度量收集的資料可以傳送至支援的「應用程式回應測量 (ARM)」代理程式。

ARM 應用程式內容

下列各表顯示要求度量起始設定 ARM 4.0 代理程式時的 ARM 應用程式內容。

表 1. 身分內容名稱和值. 下表顯示要求度量起始設定 ARM 4.0 代理程式時的 ARM 應用程式內容。
身分內容名稱
Cell 名稱 伺服器所屬的 Cell 名稱。
版本 WebSphere® Application Server 的版本。
表 2. 應用程式內容和值. 下表顯示要求度量起始設定 ARM 4.0 代理程式時的 ARM 應用程式內容。
應用程式內容
已登錄的應用程式名稱 WebSphere:<server_type>

<server_type> 可以是 APPLICATION_SERVER、ONDEMAND_ROUTER 或 PROXY_SERVER。

應用程式群組 <server_name>
應用程式實例 <node_name>.<server_name>
下列程式碼範例顯示 WebSphere Application Server 如何建立 ARM 應用程式。
String serverType; // the server type like APPLICATION_SERVER
String version; // WebSphere version
String sCellName; // the cell name of dMgr
String sAppInstance. // <short_node_name>.<short_server_name>
String sServerInstance; // short server name
String sWasName = "WebSphere:" + serverType;
String[] IDNAMES = new String[]{"Cell Name", "Version"};
ArmIdentityProperties appIdentity = txFactory.newArmIdentityProperties(IDNAMES, new String[]{sCellName,
version}, null);
ArmApplicationDefinition appDef = txFactory.newArmApplicationDefinition( sWasName, appIdentity, null );
ArmApplication app = txFactory.newArmApplication(appDef, sServerInstance, sAppInstance, null );

ARM 交易類型

您可以利用下列程式碼範例來建立 ARM 交易的實例。
String[] contextNames; // the names for the context data like Port, QueryString, URI, EJBName
String tranIdentityName; // the transaction types shown in the following table like URI, EJB.
String appDef; // defined and created in above code snippet under ARM application properties
String app; // defined and created in above code snippet under ARM application properties
ArmIdentityPropertiesTransaction props = armFactory.newArmIdentityPropertiesTransaction( null, null,
contextNames, null );
ArmTransactionDefinition atd = armFactory.newArmTransactionDefinition(appDef, identityName, props, (ArmID)null);
ArmTransaction at = txFactory.newArmTransaction(app, atd );
這個章節中的稍後各節顯示所有 ARM 交易類型及其對應的環境定義名稱。 部分交易類型不會進行檢測,除非追蹤層次設為 DEBUG。 此外,不是在所有類型的伺服器中,每個交易都可用。 所有交易類型和環境定義名稱都會區分大小寫。

統一資源識別碼 (URI)

這個交易類型是 Servlet 和 JavaServer Page (JSP) 要求的統一資源識別碼 (URI)。 在所有類型的伺服器中,下列所有交易類型和環境定義名稱都可用。

表 3. 交易類型:URI. 在所有類型的伺服器中,下列所有交易類型和環境定義名稱都可用。
交易類型:URI
環境定義名稱 說明
要求所到達的 TCP/IP 埠,指定為十進制值的字串表示法。

範例:9080

QueryString 動態 URI 的一部分,在 URI 字串的查詢區段中包含要求的搜尋參數,不含問號 (?) 字元。

範例:selection=EJB&lookup=GBL&trans=CMT

URI 所用的 Servlet 和 JSP 檔的送入要求 URI。

範例:/hitcount

Enterprise JavaBeans (EJB)

這個 EJB 交易類型和環境定義名稱只在應用程式伺服器中可供使用。

表 4. 交易類型:EJB. 這個 EJB 交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:EJB
環境定義名稱 說明
EJBName 標準 EJB 類別名稱,後面接著方法名稱,它們用句點(.)連接起來。 例如,com.mypackge.MyEJBClass.mymethod。

範例:com.ibm.defaultapplication.IncrementBean.create

ApplicationName 包含 Enterprise Bean 的 Java™ 2 Platform Enterprise Edition (J2EE) 應用程式名稱。

範例:DefaultApplication

ModuleName 包含 Enterprise Bean 的 J2EE 模組名稱。

範例:Increment.jar

Servlet 過濾器

Servlet 過濾器交易類型只在 DEBUG 追蹤層次可供使用。 對於其他層次,不會檢測 Servlet 過濾器。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。

表 5. 交易類型:Servlet 過濾器. 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:Servlet 過濾器
環境定義名稱 說明
FilterName Servlet 的 Servlet 過濾器名稱。

範例:ALoginFilter

Java 資料庫連線功能 (JDBC)

JDBC 交易類型只在 DEBUG 追蹤層次可供使用。 對於其他層次,JDBC 是一個區塊呼叫。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。

表 6. 交易類型:JDBC. 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:JDBC
環境定義名稱 說明
ClassName JDBC 呼叫的介面名稱。 這個名稱不是實際的類別名稱。

範例:java.sql.PreparedStatement

MethodName JDBC 呼叫的方法名稱。

範例:executeUpdate()

Java EE 連接器架構 (JCA)

JCA 交易類型只在 DEBUG 追蹤層次可供使用。 對於其他層次,JCA 是一個區塊呼叫。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。

表 7. 交易類型:JCA. 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:JCA
環境定義名稱 說明
ClassName JCA 呼叫的類別名稱。

範例:javax.resource.spi.ManagedConnection

MethodName JCA 呼叫的方法名稱。

範例:getConnection(Subject, ConnectionRequestInfo)

Web 服務提供者

Web 服務提供者交易類型用於伺服器端 Web 服務要求。 這個交易類型和 Wsdlport 以及 Operation 環境定義名稱在所有類型的伺服器中都可供使用。 TransportNameSpaceInputMessage 環境定義名稱只在應用程式伺服器中可供使用。

表 8. 交易類型:Web 服務提供者. 這個交易類型和 Wsdlport 以及 Operation 環境定義名稱在所有類型的伺服器中都可供使用。 TransportNameSpaceInputMessage 環境定義名稱只在應用程式伺服器中可供使用。
交易類型:Web 服務提供者  
環境定義名稱 說明
WsdlPort 與 Web 服務相關聯的 WSDL 埠名稱。

範例:AccountManager

作業 與 Web 服務相關聯的作業名稱。

範例:createNewAccount

傳輸 與 Web 服務相關聯的傳輸名稱。

範例:http

NameSpace 與 Web 服務相關聯的名稱空間。

範例:http://accountmanager.mycorp.com

InputMessage 與 Web 服務相關聯的輸入訊息名稱。

範例:createNewAccountRequest

Web 服務要求者

Web 服務要求者交易類型只在 DEBUG 追蹤層次可供使用。 對於其他層次,Web 服務要求者是一個區塊呼叫。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。

表 9. 交易類型:Web 服務要求者. 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:Web 服務要求者
環境定義名稱 說明
WsdlPort 與 Web 服務相關聯的「Web 服務說明語言 (WSDL)」埠名稱。

範例:AccountManager

作業 與 Web 服務相關聯的作業名稱。

範例:createNewAccount

傳輸 與 Web 服務相關聯的傳輸名稱。

範例:http

參數 Web 服務要求的參數。

範例:customerName,addressStreet,addressCity,addressState,addressZip

Java 訊息服務 (JMS)

JMS 交易類型只針對預設傳訊中的訊息驅動 Bean (MDB) 實務,其中包括「系統整合匯流排 (SIB)」層和 MQ。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。

表 10. 交易類型:JMS. 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:JMS
環境定義名稱 說明
DestinationName 「Java™ 訊息服務 (JMS)」的目的地佇列名稱或主題名稱。

範例:MyBusiness.Topic.Space

MessageSelector JMS 的訊息選取器。
提供者 提供者是指預設傳訊、SIB 或 MQ。

範例:預設傳訊

JMS 傳送和接收

JMS 傳送和接收交易類型只在 DEBUG 追蹤層次可供使用。 對於其他層次,JMS 傳送和接收是一個區塊呼叫。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。

表 11. 交易類型:JMS 傳送/接收. 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:JMS 傳送/接收
環境定義名稱 說明
ClassName 在 JMS 提供者中,發出呼叫的類別名稱。

範例:com.ibm.ws.sib.api.jms.impl.JmsTopicPublisherImpl

MethodName 在 JMS 提供者中,發出呼叫的方法名稱。

範例:sendMessage

服務整合匯流排 (SIB) 傳送和接收

SIB 傳送和接收交易類型只在 DEBUG 追蹤層次可供使用。 對於其他層次,SIB 傳送和接收是一個區塊呼叫。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。

表 12. 交易類型:SIB 傳送/接收. 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:SIB 傳送/接收。
環境定義名稱 說明
ClassName 在 SIB 層中,發出呼叫的類別名稱。

範例:com.ibm.ws.sib.processor.impl.ProducerSessionImpl

MethodName 在 SIB 層中,發出呼叫的方法名稱。

範例:send

BusName 這個呼叫所對的「服務整合匯流排」的名稱。
DestinationName 這個呼叫所對的「服務整合目的地」的名稱。

SIB 訊息驅動 Bean (MDB)

SIB MDB 交易類型只在應用程式伺服器中可供使用。

表 13. 交易類型:SIB MDB. SIB MDB 交易類型只在應用程式伺服器中可供使用。
交易類型:SIB MDB。
環境定義名稱 說明
BusName MDB 在接聽中的「目的地」所在的 SIB 名稱。
DestinationName 這個 MDB 也在接聽的 SIB 的名稱。
MessageSelector 這個 MDB 所用的訊息選取器。
MdbDiscriminator 這個 MDB 所用的鑑別器。
提供者 這個 MDB 所針對的提供者類型。

範例:預設傳訊或 SIB

SIB 調解

SIB 調解交易類型和環境定義名稱只在應用程式伺服器中可供使用。

表 14. 交易類型:SIB 調解. SIB 調解交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:SIB 調解
環境定義名稱 說明
ClassName 發出呼叫時所在的類別名稱。
MethodName 發出呼叫時所在的方法名稱。
MediationName JMS 的調解名稱。

範例:myMediation

BusName JMS 的服務整合匯流排名稱。

範例:thisBusName

DestinationName JMS 的目的地名稱。

範例:myMessageQueue

非同步 Bean

非同步 Bean 交易類型是針對未設定 LONGRUNNING_HINT 的非同步 Bean 計時器、警示、延遲啟動及 EE Concurrency 作業。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。

表 15. 交易類型:非同步 Bean. 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:非同步 Bean
環境定義名稱 說明
類型 非同步 Bean 作業的類型。

範例:COMMONJ_TIMER

ClassName 執行非同步 Bean 作業的類別名稱。

範例:com.mycorp.MyTaskClass

Java 命名和目錄介面 (JNDI)

JNDI 交易類型只在 DEBUG 追蹤層次可供使用。 對於其他跟蹤層次,將不會檢測 JNDI 呼叫。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。

表 16. 交易類型:JNDI. 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:JNDI
環境定義名稱 說明
JNDIName JNDI 查閱名稱。

範例:ejbJndiName

Portlet

Portlet 交易類型和環境定義名稱只在應用程式伺服器中可供使用。

表 17. 交易類型:Porlet. Portlet 交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:Portlet
環境定義名稱 說明
方法 目前使用的 Portlet 的方法,可能是動作或呈現。
WindowID 目前在使用的 Portlet 的視窗 ID。
URI(這是一個 ARM 交易環境定義內容名稱,不應與在 WebSphere Servlet 交易上指定的明確 ARM 交易 URI 內容混淆,尤其不應與 Enterprise Workload Manager (EWLM) "EWLM: URI" 原則過濾器混淆。) 現行 Portlet 要求的環境定義路徑。

透過 HTTP 和 SOAP 通訊協定的 ARM 相關性因子

對於 HTTP 入埠,WebSphere Application Server 會檢查送入 ARM 相關性因子的 HTTP 標頭 “ARM_CORRELATOR”(區分大小寫)。 應用程式伺服器不容許透過 HTTP 出埠的 ARM 相關性因子流程。

對於 SOAP 入埠,WebSphere Application Server 會檢查元素的 SOAP 標頭如下:
  • element ="arm_correlator";
  • namespace URI = "http://websphere.ibm.com",
  • prefix = "reqmetrics";
  • actor URI = "reqmetricsURI";
對於 SOAP 出埠,WebSphere Application Server 會建立新的 SOAP 標頭,且會在標頭中,將 ARM 相關性因子字串作為文字節點來傳遞。 例如:
  • element ="arm_correlator";
  • namespace URI = "http://websphere.ibm.com",
  • prefix = "reqmetrics";
  • actor URI = "reqmetricsURI";
以下是含有 ARM 相關性因子的 SOAP 標頭範例。 請注意,無論是使用 HTTP 或 SOAP 通訊協定,都必須以 ARM 相關性因子位元組陣列的十六進位字串格式來傳遞 ARM 相關性因子。
<soapenv:Header xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<reqmetrics:arm_correlator soapenv:actor="reqmetricsURI" xmlns:reqmetrics="http://websphere.ibm.com">
37000000000000000000
</reqmetrics:arm_correlator>
</soapenv:Header>

指出主題類型的圖示 參照主題



時間戳記圖示 前次更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rprf_armproperties
檔名:rprf_armproperties.html