实施指南 › 实施 › 数据收集（数据源专家） › 如何配置适配器和转换 › 文件适配器案例研究 › 配置文件的 TranslatorCollection 部分

配置文件的 TranslatorCollection 部分

TranslatorCollection 部分定义如何将在前面部分中提取的已解析和已处理数据源记录转换为 CA Business Service Insight 事件。

本部分还定义如何处理重复事件以及如何使用事件单一性机制（有关更多详细信息，请参阅事件单一性）。

将界面模式设置为联机时，CA Business Service Insight 事件具有包含以下字段的统一结构：

• Timestamp：事件出现的时间。
• ResourceId：与事件关联的资源 ID（在该事件中度量的资源）。
• EventTypeId：与事件关联的事件类型并描述事件的类型（资源的度量类型、故障单操作的类型等）。
• DataSourceId（可选）：任意值。 向原始数据事件提供其他筛选条件。
• Value（多个）：事件的值（度量结果、故障单数目等）。 此字段通常出现多次。

转换器的结构与 CA Business Service Insight 中的事件类型结构以及存储事件的数据库表 T_RAW_DATA 相对应，如下图所示：

• Translator：描述如何将接收到的字段集转换成输出事件。
• TranslatorName：InputFormat 用来向此转换器发送字段集的名称。 此示例使用名称“Translator1”。 有关可用于此方案的值的信息，请参考上图。
• TranslatorFields：包含 TranslatorField 元素的列表，其中每个元素都包含以下属性：
  • Name：字段名称。 在联机界面中，它必须是 Timestamp、ResourceId、EventTypeId 或 Value。
  • SourceType：指定字段值的源。 可为以下各项之一：
    • Field：此字段的值取自输入格式中的字段。 SourceName 属性包含 InputFormat 字段名称。
    • Table：此字段的值取自转换表。 SourceName 属性包含转换表名称，它表示在下一部分 TranslationTableCollection 中定义的名称。 此类型用于被选择要转换为事件中的资源和事件类型的值。
    • Lookup：此字段的值取自转换表。 SourceName 属性包含表名。 要转换的值来自 LookupValue 属性，而不是输入格式。 在需要使用常量值进行转换时，通常使用该值。
    • Constant：字段的值为常量，其值在 ConstantValue 属性中。 在使用常量值时，需要使用 Type 属性指定字段类型。
  • SourceName：包含字段名称或转换表名称。
  • LookupValue：当 SourceType="lookup" 时包含查找值。
  • ConstantValue：当 SourceType="constant" 时包含常量值。 当字段的类型为时间时，会根据 TimeFormat（在适配器的 General 部分设置）将常量值格式化为字符串，或者格式化为“Now”、“NowUtc”，其中“Now”是数据源区域设置中的当前时间，“NowUtc”是 UTC 当前时间。

本部分还包含映射表（用于定义数据源值到 CA Business Service Insight 事件字段的映射），并保存有表定义以及要转换的被引用数据源值。

• LoadingMode：联机接口的默认设置为“remote”，脱机接口的默认设置为“standalone”。

  对转换表的加载方法指定如下：

  • Standalone：适配器在本地加载转换表。 与关于转换的 CA Business Service Insight 服务器之间没有连接。 转换表中的更改只存储在本地文件中。
  • Remote：适配器发送请求以便从 CA Business Service Insight 服务器加载所有表。 在转换表中所做的更改也会存储在本地。
• TranslationTable：将事件值链接到映射表。
  • Name：转换器使用和引用的转换表的名称。
  • DestinationType：[resource, event_type, contract_party, service, time_zone, value]。 保存转换表的类型。 在该示例中，数据源文件中的服务器列将转换为 CA Business Service Insight 资源。 因此，转换表类型为资源，它保存值到 CA Business Service Insight 中资源 ID 的转换。
  • TranslationField：要转换的字段名称，取自输入格式字段。 最多可以包含五个字段。

在配置文件中定义的每个转换表都必须在 CA Business Service Insight 用户界面中有相应的定义。

以下是一个示例配置文件的 XML 表示：

<?xml version="1.0" encoding="utf-8"?>
<AdapterConfiguration>
     <General MajorVersion="4" MinorVersion="0" RunOnce="yes" LogDebugMode="yes"
ConsoleDebugMode="yes" WorkingDirectoryName="output" RejectedEventsUpperLimit="10000">
     <DataSourceDifferenceFromUTC DefaultOffset="0" TimeFormat="%d/%m/%Y %H:%M">
          <DaylightSaving From="20/04/2001 00:00" To="15/10/2001 00:00" Shift="1"/>
     </DataSourceDifferenceFromUTC>
</General>
     <OblicoreInterface Mode="online">
          <OnlineInterface Port="5555" SecurityLevel="none"/>
     </OblicoreInterface>
     <DataSourceInterface>
          <Files>
               <File DeleteFileAfterProcessing="no" InputFormat="InputFormat1" NamePattern="servers*.csv" Path=" C:\Program Files\Oblicore\Adapters\ServersAdapter\data\" TitleExists="yes" SleepTime="60" Delimiters=","/>
      </Files>
</DataSourceInterface>
<InputFormatCollection>
     <InputFormat InputFormatName="InputFormat1">
          <InputFormatFields>
               <InputFormatField Name="resource" Type="string"/>
                    <InputFormatField Name="timestamp" Type="time" TimeFormat="%d.%m.%Y %H:%M"/>
                        <InputFormatField Name="memory_util" Type="real"/>
                        <InputFormatField Name="cpu_util" Type="real"/>
                </InputFormatFields>
     <TranslatorSwitch DefaultTranslator="Translator1"/>
     </InputFormat>
</InputFormatCollection>
<TranslatorCollection>
<Translator TranslatorName="Translator">
         <TranslatorFields>
            <TranslatorField Name="ResourceId" SourceType="table" SourceName="ResourceTable"/>
            <TranslatorField Name="EventTypeId" SourceType="lookup" SourceName="EventTable" LookupValue="PerformanceEvent"/>
            <TranslatorField Name="Timestamp" SourceType="field" SourceName="timestamp"/>
            <TranslatorField Name="Value" SourceType="field" SourceName="memory_util"/>
            <TranslatorField Name="Value" SourceType="field" SourceName="cpu_util"/>
         </TranslatorFields>
      </Translator>
   </TranslatorCollection>
   <TranslationTableCollection LoadingMode="remote">
      <TranslationTable Name="ResourceTable" DestinationType="resource">
         <TranslationField>resource</TranslationField>
      </TranslationTable>
      <TranslationTable Name="EventTable" DestinationType="event_type">
         <TranslationField>resource</TranslationField>
      </TranslationTable>
   </TranslationTableCollection>
</AdapterConfiguration>