为活动应用程序监视配置适配器

“通用日志适配器”提供了一个输出程序类，使得可以将适配器生成的“公共基本事件”对象发送至记录代理程序。“日志和跟踪分析器”可用来连接至记录代理程序以实时监视和分析应用程序日志。

先决条件：

请遵循下列步骤来配置适配器以进行监视。

更新输出程序组件

注意：当创建新的适配器配置文件时，会将它配置为在缺省情况下使用 CBELogOutputter 类。如果未更改此设置，则可以跳过此过程。

需要更新适配器配置文件中的输出程序组件以使用 CBELogOutputter 类，该类将“公共基本事件”对象写至记录代理程序。可以更新现有输出程序组件或添加新的输出程序组件。

要添加新的输出程序组件：

  1. 要编辑适配器配置文件，在“导航器”窗格中选择适配器配置文件。右键单击并选择打开方式 > 适配器配置编辑器。该文件就会在编辑器中打开。
  2. 在“适配器配置编辑器”窗口中，展开适配器 > 配置 > 上下文实例节点。
  3. 右键单击“上下文实例”并选择添加 > 输出程序。这就会在“上下文实例”中创建新的输出程序。
  4. 在输出程序类型字段中，选择 LoggingAgentOutputter。
  5. 单击代理程序名属性。属性详细信息会显示在右窗格中。
  6. 将该属性值更新为期望的记录代理程序名称。该名称就是将在“日志和跟踪分析器”中看到的要监视的“记录代理程序”的名称。
  7. 如果想要输出程序在将信息记录至 CBELogOutputter 类之前等待一段时间，则添加称为等待记录时间（waitUntilLoggingTime）的属性并将该属性的值设置为以毫秒为单位的时间。要添加该属性，右键单击新创建的输出程序并选择添加 > 属性。这就会在新的“输出程序”节点下面创建新的属性。
  8. 要启用 CBELogOutputter 类，需要在“上下文基本上下文实现”中创建相关联的“输出程序”组件。打开上下文 > 上下文基本实现上下文。
  9. 右键单击上下文基本实现上下文并选择添加 > 组件。这就会将新的组件添加至上下文。
  10. 使用下列值配置新组件：
    名称： 上下文中的输出程序名称
    描述： 对此输出程序执行的任务的描述
    可执行的类： org.eclipse.hyades.logging.adapter.outputters.CBELogOutputter
    记录级别：输出程序组件应使用的内部记录级别。
    值 99 表示输出程序将不记录任何消息。
    值 0 表示输出程序将记录所有严重性的消息。
    建议值是 50，表示只记录“紧急”或“致命”内部输出程序错误消息。
    角色： 输出程序
    唯一标识： 必须指向步骤 2 中在“上下文实例”中定义的输出程序。使用浏览按钮来选择正确的标识。
  11. 保存适配器配置文件更改。

更新上下文实例

如果想要日志解析器连续地监视日志文件，则需要更新连续操作的适配器配置文件的上下文实例属性。

  1. 要编辑适配器配置文件，在“导航器”透视图中选择适配器配置文件。右键单击并选择打开方式 > 适配器配置编辑器。该文件就会在编辑器中打开。
  2. 在编辑器窗口中，选择适配器 > 配置 > 上下文实例。“上下文实例”详细信息会显示在右窗格中。
  3. 选择连续操作复选框。
  4. 根据需要配置“最大空闲时间”和“暂停时间间隔”字段。
  5. 保存适配器配置文件更改。

启动 Java 进程以运行适配器

可以从批处理文件（在 Windows 环境中）或 shell 脚本（在非 Windows 环境中）在外部运行所创建的日志适配器。下面是可用来启动将运行日志适配器的 Java 进程的一些样本文件。
注意：要在系统上运行“通用日志适配器”，必须在该系统上安装 Hyades。

Windows 批处理文件：

@rem USAGE:  runregex
@rem Change the following lines to point to the directory where you unzipped the runtime
@rem and the directory where your log adapter resides
SET HYADES_HOME=d:\hyadesDC
SET YOUR_ADAPTER_DIRECTORY=MyAdapterDirectory
SET CONFIG_FILE=%HYADES_HOME%\%YOUR_ADAPTER_DIRECTORY%\myadapter.adapter
PUSHD %HYADES_HOME%\%YOUR_ADAPTER_DIRECTORY%
java -classpath "%HYADES_HOME%\lib\glaconfigs.jar;%HYADES_HOME%\lib\hexr.jar;%HYADES_HOME%\lib\hgla.jar;%HYADES_HOME%\lib\hglaconfig.jar;%HYADES_HOME%\lib\hlcore.jar;%HYADES_HOME%\lib\hlevents.jar;%HYADES_HOME%\lib\hparse.jar;;%HYADES_HOME%\lib\logparsers.jar;%HYADES_HOME%\lib\xalan.jar;" org.eclipse.hyades.logging.adapter.Adapter -ac "%CONFIG_FILE%" -cc "%CONFIG_FILE%"
POPD
非 Windows 批处理文件：
#!/bin/sh
# USAGE:  runregex_example.sh
# Change the following line to point to the directory where you unzipped the runtime
HYADES_HOME=/home/hyadesDC
export HYADES_HOME
YOUR_DIRECTORY=/yourdirectory
export YOUR_DIRECTORY

CONFIG_FILE=$HYADES_HOME/$YOUR_DIRECTORY/myadapter.adapter
export CONFIG_FILE

CUR_DIR=`pwd`
export CUR_DIR

cd $HYADES_HOME/$YOUR_DIRECTORY

java -classpath "$HYADES_HOME\lib\glaconfigs.jar;$HYADES_HOME\lib\hexr.jar;$HYADES_HOME\lib\hgla.jar;$HYADES_HOME\lib\hglaconfig.jar;$HYADES_HOME\lib\hlcore.jar;$HYADES_HOME\lib\hlevents.jar;$HYADES_HOME\lib\hparse.jar;;$HYADES_HOME\lib\logparsers.jar;$HYADES_HOME\lib\xalan.jar;" org.eclipse.hyades.logging.adapter.Adapter -ac "$CONFIG_FILE" -cc "$CONFIG_FILE"
cd $CUR_DIR
根据需要配置文件以启动将运行适配器的 Java 进程。

监视活动的应用程序日志

现在就可以监视活动的应用程序日志了。

  1. 确保在首选项中启用了记录。
    1. 从主工具栏中选择窗口 > 首选项。“首选项”向导打开。
    2. 从左窗格中选择概要分析和记录。会在右窗格中装入“概要分析和记录”首选项。
    3. 在“概要分析和记录”选项下面选择启用记录。

      在“概要分析和记录”的首选项窗格中选择了启用记录复选框

    4. 选择确定以应用更改。
  2. 在“概要分析和记录”透视图中，单击工具栏中的“概要分析” 概要分析工具的图标 图标并选择概要分析。“概要分析”向导打开。
  3. 选择连接 － Java 进程并单击列表底部的新建按钮。这就会创建新的 Java 进程配置。
  4. 单击主机选项卡并选择应用程序日志所驻留的主机。
    注意：要监视活动的应用程序日志，“Hyades 数据收集引擎”必须正在应用程序所在的同一系统上运行。
  5. 单击代理程序选项卡并使用箭头键来选择所配置的记录代理程序。

    在概要分析首选项向导中，用户创建的记录代理程序在左窗格中

  6. 单击应用。
  7. 单击运行以连接至记录代理程序。
  8. 在“概要分析和记录”透视图的“概要分析监视器”视图中，选择记录代理程序。
  9. 右键单击该代理程序并选择开始监视。
  10. 右键单击该代理程序并选择打开方式 > 日志视图。会将应用程序日志中的日志事件装入“日志”视图。

 

相关概念
Hyades 通用日志适配器概述
公共基本事件格式规范

相关任务
创建日志解析器

相关参考
适配器配置文件结构
适配器配置编辑器
正则表达式语法