如何将自定义解码添加到 Transaction Analyzer
要将自定义解码器添加到 Transaction Analyzer,需要完成两项总体操作:
- 创建包含该代码的共享对象库。
- 通知 Transaction Analyzer 使用它。
编译与链接
自定义解码器使用的所有函数都必须包含在同一个 <decoder_name>.ets.c 文件中。务必包含 ace_client_api.h、ace_externals.h 以及所用其他包的头文件。使用以下命令编译该文件(关于该程序的更多细节参见“op_mko”(第 181 页)):
op_mko -m <decoder_name> -type ets
编译完成后,使用 op_mkso 将自定义解码器打包到一个或多个共享对象文件中(op_mkso 的说明见“op_mkso”(第 187 页))。例如:
op_mkso -type ets
-f <decoder_name_1>.dev32.i0.ets.obj ... <decoder_name_n>.dev32.i0.ets.obj
-m <decoder_library_name>.dll
其中
- -f 指定要包含在库中的一个或多个目标文件列表(带扩展名的文件名)。
- -m 指定输出文件(带扩展名的文件名)。
注意: 上面的示例使用 Windows 文件扩展名。在 Linux 上,目标文件以 .o 结尾,库文件以 .so 结尾。
通知 Transaction Analyzer
自定义解码器要被识别和使用,必须在 ace_decoder_config.gdf 文件中列出,该文件位于 <reldir>\sys\configs 目录。打开此文件并按以下方式编辑:
- 为创建的每个解码器库添加一个条目,如下所示(粗体文本为新添加的内容):
# IN THIS SECTION OF THE GDF FILE WE DEFINE WHAT DECODERS
# ARE PRESENT IN A PARTICULAR SHARED OBJECT FILE
Shared_Object ace_decoder
Decoder_List op_dlc op_tr op_ri op_udp op_tcp op_llc op_snap op_ip op_prn op_nai
op_nai_enhance op_csv op_http op_ica
Shared_Object <decoder_library_name>
Decoder_List <decoder_name_1> ... <decoder_name_n>
- 将解码器库中的每个解码器添加到一个或多个现有的解码器集合(decoder set)中。通常将它们添加到 Windows 和 Linux 的 op_binary 集合中,如下所示:
# IN THIS SECTION OF THE GDF FILE WE DEFINE WHICH DECODERS
# Should be used depending on what type of file is being
imported.
Decoder_Set_Sequence op_binary
File_Type binary
Platform UNIX
Product_Options NONE
Decoder_Set op_tr op_ri op_dlc op_llc op_snap op_ip op_udp op_tcp <decoder_name_1>
... <decoder_name_n>
. . .
Decoder_Set_Sequence op_binary
File_Type binary
Platform WINDOWS
Product_Options NONE
Decoder_Set op_tr op_ri op_dlc op_llc op_snap op_ip op_udp op_tcp <decoder_name_1>
... <decoder_name_n>