适配器配置文件扩展
可以通过创建可包含在上下文中的定制组件来扩展通用日志适配器。以下列示了可以扩展的组件。
- 传感器:传感器提供一种机制以读取要进行处理的内容。
- 抽取器:抽取器接收传感器提供的输入行集合,并将它们分隔到不同的消息范围中。
- 解析器:解析器接收用抽取器定界的消息,并构建字符串值到数据结构的一组映射(公共基本事件)。
- 格式化程序:格式化程序接收属性与它们的值(由解析器提供)的映射,并构建正确的 JavaTM 对象实例(公共基本事件)。
- 输出程序:输出程序对由格式化程序产生的公共基本事件记录进行外部化。输出程序提供该机制或将其打包以便存储上下文的最终输出。
自主计算在 com.ibm.etools.logging.adapter Eclipse 插件中提供了下列组件。类打包在 glacomponents.jar 文件中。要使用这些组件中的任何一个,必须将 glacomponents.jar 包括在类路径中。
传感器
- com.ibm.etools.logging.adapter.sensors.CEIQuerySensor:此传感器使用 JDBC-ODBC 连接来连接到指定的 Common Event Infrastructure 数据库,并将每个从该数据库接收到的结果转换为公共基本事件 XML 字符串。
- com.ibm.etools.logging.adapter.sensors.ODBCQueryExecSensor:此传感器使用 JDBC-ODBC 连接来连接到指定的数据库,并将从该数据库接收到的每一行转换为 XML 记录字符串。
- com.ibm.etools.logging.adapter.sensors.SNMPSensor:此传感器接收指定端口上的 SNMP 陷阱,并将其转换为公共基本事件对象。
- org.eclipse.hyades.logging.adapter.sensors.SiebelSensor:可以使用此传感器来监视多个同名文件。例如,一个同时更新多个日志文件的应用程序。
传感器类型 |
属性 |
CEIQuerySensor |
- IBMCEISensorDSNName
- 用来连接至数据库的 DSN 字符串。此字符串包含主机名和端口号。
- IBMCEISensorlogID
- 一种密钥,用来访存与此密钥相关联的一组公共基本事件。
- IBMCEISensorUserName
- 用于数据库登录的用户标识。
- IBMCEISensorPassword
- 用于数据库登录的用户密码。
- IBMCEISensorQueryString
- 用来访存数据的 XPath 查询字符串。
- IBMCEISensorDriverName
- 用来连接至数据库的驱动程序名。
- IBMCEISensorJDBCLocation
- 用来连接至数据库的驱动程序的 JAR 文件位置。
|
ODBCQueryExecSensor |
- IBMGAODBCSensorDSNName
- DSN 名称
- IBMGAODBCSensorDatabaseName
- 数据库名称
- IBMGAODBCSensorUserName
- 用来访问数据库的用户名。
- IBMGAODBCSensorPassword
- 与 IBMGAODBCSensorUserName 同时使用以访问数据库的密码。
- IBMGAODBCSensorQueryString
- 数据库查询字符串
- IBMGAODBCSensorDriverName
- 要使用的 ODBC 驱动程序的名称。
|
SiebelSensor |
- directory(必需)
- SiebelSensor 将读取的文件的目录位置。
- fileName(必需)
- SiebelSensor 将读取的文件的名称。如果应用程序同时更新多个文件,则可以使用正则表达式来指定文件名。
|
SNMPSensor |
- IBMGASNMPSensorSNMPPort
- SNMP 端口号。162 是所使用的缺省端口号。
|
输出程序
输出程序包含下列属性:
输出程序类型 |
属性 |
AMEWebServicesOutputter |
- resourceName
- 此属性用来指定受管资源的名称,例如,自主管理引擎将使用 MRId 来识别资源。此属性的值必须唯一。
- bufferSize
- 此属性用来指定输出缓冲区的大小。提供此缓冲区的目的是为了避免输出程序在发送事件时出现阻塞。这不是必需属性。此属性的缺省值是 50。
- rmiRegistryPort
- 此属性用来指定通用日志适配器将创建 RMI 注册程序所在的端口。如果已经提供注册程序,则通用日志适配器将使用此注册程序。应该将 GLASubscriber Web service 和日志适配器配置为使用相同的 RMI 注册程序。
- waitUntilTime
- 此可选属性用来指定输出程序等待时间。如果该值小于 0,则输出程序将等待,直到管理器启动。如果该值等于 0,则输出程序无需等待即可发送公共基本事件。如果该值为 x,则对于每个公共基本事件,在管理器通知输出程序发送公共基本事件之前输出程序将等待 x 毫秒。
|
CEIOutputter |
- factoryName
- 发射器工厂用来获取要向其发送公共基本事件的 CEI 发射器。此属性为可选属性。如果未指定此属
性,则将使用缺省发射器工厂 com/ibm/events/configuration/emitter/Default。
- synchronizationMode
- 可以采用同步方式或异步方式发送事件。此属性为可选属性。如果未指定此属性,则将使用在发射器
工厂概要文件中指定的缺省同步方式。有效值为同步方式和异步方式。
- transactionMode
- 发送事件时,可以将发射器配置为在客户机所处的相同事务中发送事件,或者在新的事务中发送事件。此属性为可选属性。如果未指定此属性,则将使用在发射器工厂概要文件中指定的缺省事务方式。这些有效值为相同事务和
新的事务。
- providerURL
- 指定将用来查询 EmitterFactory 的远程 Java 命名和目录接口(JNDI)提供程序的 URL。
|
WEF11Outputter |
- directory
- 文件名的相对或绝对目录路径。
- fileName
- 文件的名称(可以是正则表达式)。
|
WSNotificationOutputter |
- resourceId
- 此属性用来为通用日志适配器的特定上下文指定唯一标识。该值将作为 id 属性添加至 WS-Notification 的主题。如果未使用此属性,则 id 属性将为空。
- endPointReference
- 此属性用来指定必须向其发送事件的服务的端点引用。如果要向所需服务发送事件,则必须指定此属性。
- callTimeOut
- 此属性用来指定套接字连接的超时。对于本地连接,建议值为 10;而对于远程连接,建议值为 100。您可以在 hgla.log 文件中查找与此套接字连接相关的异常。
|
相关概念
通用日志适配器概述
适配器配置编辑器
相关任务
部署日志解析器插件项目
创建日志解析器
创建基于规则的适配器
相关参考
适配器配置文件结构
正则表达式语法
公共基本事件格式规范
公共基本事件和 Common Event Infrastructure 的最佳实践
(C) Copyright IBM Corporation 2000, 2006. All Rights
Reserved.