ARM 應用程式內容和交易環境定義資料
要求度量提供內建的檢測來監視交易流程。 要求度量收集的資料可以傳送至支援的「應用程式回應測量 (ARM)」代理程式。
ARM 應用程式內容
下列各表顯示要求度量起始設定 ARM 4.0 代理程式時的 ARM 應用程式內容。
身分內容名稱 | 值 |
---|---|
Cell 名稱 | 伺服器所屬的 Cell 名稱。 |
版本 | WebSphere® Application Server 的版本。 |
應用程式內容 | 值 |
---|---|
已登錄的應用程式名稱 | WebSphere:<server_type>
<server_type> 可以是 APPLICATION_SERVER、ONDEMAND_ROUTER 或 PROXY_SERVER。 |
應用程式群組 | <server_name> |
應用程式實例 | <node_name>.<server_name> |
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 交易類型
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 );
統一資源識別碼 (URI)
這個交易類型是 Servlet 和 JavaServer Page (JSP) 要求的統一資源識別碼 (URI)。 在所有類型的伺服器中,下列所有交易類型和環境定義名稱都可用。
交易類型:URI | |
---|---|
環境定義名稱 | 說明 |
埠 | 要求所到達的 TCP/IP 埠,指定為十進制值的字串表示法。
範例:9080 |
QueryString | 動態 URI 的一部分,在 URI 字串的查詢區段中包含要求的搜尋參數,不含問號 (?) 字元。
範例:selection=EJB&lookup=GBL&trans=CMT |
URI | 所用的 Servlet 和 JSP 檔的送入要求 URI。 範例:/hitcount |
Enterprise JavaBeans (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 過濾器。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:Servlet 過濾器 | |
---|---|
環境定義名稱 | 說明 |
FilterName | Servlet 的 Servlet 過濾器名稱。
範例:ALoginFilter |
Java 資料庫連線功能 (JDBC)
JDBC 交易類型只在 DEBUG 追蹤層次可供使用。 對於其他層次,JDBC 是一個區塊呼叫。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:JDBC | |
---|---|
環境定義名稱 | 說明 |
ClassName | JDBC 呼叫的介面名稱。
這個名稱不是實際的類別名稱。
範例:java.sql.PreparedStatement |
MethodName | JDBC 呼叫的方法名稱。
範例:executeUpdate() |
Java EE 連接器架構 (JCA)
JCA 交易類型只在 DEBUG 追蹤層次可供使用。 對於其他層次,JCA 是一個區塊呼叫。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:JCA | |
---|---|
環境定義名稱 | 說明 |
ClassName | JCA 呼叫的類別名稱。
範例:javax.resource.spi.ManagedConnection |
MethodName | JCA 呼叫的方法名稱。
範例:getConnection(Subject, ConnectionRequestInfo) |
Web 服務提供者
Web 服務提供者交易類型用於伺服器端 Web 服務要求。 這個交易類型和 Wsdlport 以及 Operation 環境定義名稱在所有類型的伺服器中都可供使用。 Transport、NameSpace 和 InputMessage 環境定義名稱只在應用程式伺服器中可供使用。
交易類型:Web 服務提供者 | |
---|---|
環境定義名稱 | 說明 |
WsdlPort | 與 Web 服務相關聯的 WSDL 埠名稱。
範例:AccountManager |
作業 | 與 Web 服務相關聯的作業名稱。
範例:createNewAccount |
傳輸 | 與 Web 服務相關聯的傳輸名稱。
範例:http |
NameSpace | 與 Web 服務相關聯的名稱空間。
範例:http://accountmanager.mycorp.com |
InputMessage | 與 Web 服務相關聯的輸入訊息名稱。
範例:createNewAccountRequest |
Web 服務要求者
Web 服務要求者交易類型只在 DEBUG 追蹤層次可供使用。 對於其他層次,Web 服務要求者是一個區塊呼叫。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:Web 服務要求者 | |
---|---|
環境定義名稱 | 說明 |
WsdlPort | 與 Web 服務相關聯的「Web 服務說明語言 (WSDL)」埠名稱。
範例:AccountManager |
作業 | 與 Web 服務相關聯的作業名稱。
範例:createNewAccount |
傳輸 | 與 Web 服務相關聯的傳輸名稱。
範例:http |
參數 | Web 服務要求的參數。
範例:customerName,addressStreet,addressCity,addressState,addressZip |
Java 訊息服務 (JMS)
JMS 交易類型只針對預設傳訊中的訊息驅動 Bean (MDB) 實務,其中包括「系統整合匯流排 (SIB)」層和 MQ。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:JMS | |
---|---|
環境定義名稱 | 說明 |
DestinationName | 「Java™ 訊息服務 (JMS)」的目的地佇列名稱或主題名稱。
範例:MyBusiness.Topic.Space |
MessageSelector | JMS 的訊息選取器。 |
提供者 | 提供者是指預設傳訊、SIB 或 MQ。
範例:預設傳訊 |
JMS 傳送和接收
JMS 傳送和接收交易類型只在 DEBUG 追蹤層次可供使用。 對於其他層次,JMS 傳送和接收是一個區塊呼叫。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:JMS 傳送/接收 | |
---|---|
環境定義名稱 | 說明 |
ClassName | 在 JMS 提供者中,發出呼叫的類別名稱。
範例:com.ibm.ws.sib.api.jms.impl.JmsTopicPublisherImpl |
MethodName | 在 JMS 提供者中,發出呼叫的方法名稱。
範例:sendMessage |
服務整合匯流排 (SIB) 傳送和接收
SIB 傳送和接收交易類型只在 DEBUG 追蹤層次可供使用。 對於其他層次,SIB 傳送和接收是一個區塊呼叫。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:SIB 傳送/接收。 | |
---|---|
環境定義名稱 | 說明 |
ClassName | 在 SIB 層中,發出呼叫的類別名稱。
範例:com.ibm.ws.sib.processor.impl.ProducerSessionImpl |
MethodName | 在 SIB 層中,發出呼叫的方法名稱。
範例:send |
BusName | 這個呼叫所對的「服務整合匯流排」的名稱。 |
DestinationName | 這個呼叫所對的「服務整合目的地」的名稱。 |
SIB 訊息驅動 Bean (MDB)
SIB MDB 交易類型只在應用程式伺服器中可供使用。
交易類型:SIB MDB。 | |
---|---|
環境定義名稱 | 說明 |
BusName | MDB 在接聽中的「目的地」所在的 SIB 名稱。 |
DestinationName | 這個 MDB 也在接聽的 SIB 的名稱。 |
MessageSelector | 這個 MDB 所用的訊息選取器。 |
MdbDiscriminator | 這個 MDB 所用的鑑別器。 |
提供者 | 這個 MDB 所針對的提供者類型。
範例:預設傳訊或 SIB |
SIB 調解
SIB 調解交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:SIB 調解 | |
---|---|
環境定義名稱 | 說明 |
ClassName | 發出呼叫時所在的類別名稱。 |
MethodName | 發出呼叫時所在的方法名稱。 |
MediationName | JMS 的調解名稱。
範例:myMediation |
BusName | JMS 的服務整合匯流排名稱。
範例:thisBusName |
DestinationName | JMS 的目的地名稱。
範例:myMessageQueue |
非同步 Bean
非同步 Bean 交易類型是針對未設定 LONGRUNNING_HINT 的非同步 Bean 計時器、警示、延遲啟動及 EE Concurrency 作業。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:非同步 Bean | |
---|---|
環境定義名稱 | 說明 |
類型 | 非同步 Bean 作業的類型。
範例:COMMONJ_TIMER |
ClassName | 執行非同步 Bean 作業的類別名稱。
範例:com.mycorp.MyTaskClass |
Java 命名和目錄介面 (JNDI)
JNDI 交易類型只在 DEBUG 追蹤層次可供使用。 對於其他跟蹤層次,將不會檢測 JNDI 呼叫。 這個交易類型和環境定義名稱只在應用程式伺服器中可供使用。
交易類型:JNDI | |
---|---|
環境定義名稱 | 說明 |
JNDIName | JNDI 查閱名稱。
範例:ejbJndiName |
Portlet
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 相關性因子流程。
- element ="arm_correlator";
- namespace URI = "http://websphere.ibm.com",
- prefix = "reqmetrics";
- actor URI = "reqmetricsURI";
- element ="arm_correlator";
- namespace URI = "http://websphere.ibm.com",
- prefix = "reqmetrics";
- actor URI = "reqmetricsURI";
<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>