本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 从头开始创建对 log-group-level数转换器
<a name="CloudWatch-Logs-Transformation-CreateNew"></a>

使用这些步骤从头开始创建 log-group-level变压器。

**使用控制台为日志组创建日志转换器**

1. 打开 CloudWatch 控制台，网址为[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)。

1. 在导航窗格中，依次选择**日志**和**日志组**。

1. 选择要为其创建转换器的日志组。

1. 选择**转换器**选项卡。您可能需要向右滚动选项卡列表才能看到它。

1. 选择**创建转换器**。

1. 在**选择解析器**框中，选择要包含在转换器中的解析器。

   如果它是预先配置的解析器，则无需为其指定任何配置。 AWS 

   如果是其他解析器，则需要指定其配置。有关更多信息，请参阅[可配置的解析器类型处理器](CloudWatch-Logs-Transformation-Configurable.md)中该处理器的相关信息。

1. 要添加其他处理器，请选择 **\$1 添加处理器**。然后在**选择处理器**框中选择所需的处理器，并填写配置参数。

   请记住，处理器会按照您将日志事件添加到转换器的顺序对其进行操作。

1. （可选）您可以随时测试迄今为止您根据示例日志事件构建的转换器。为此，请执行以下操作：

   1. 在**转换预览**部分，选择**加载示例日志**以从此转换器适用的日志组加载示例日志事件，或者将日志事件粘贴到文本框中。

     选择**测试转换器**。随后会显示日志的转换后版本 

1. 添加完处理器并对示例日志的测试感到满意后，请选择**保存**。

**使用从头 AWS CLI 开始创建对数转换器**
+ 使用 `aws logs put-transformer` 命令。当使用 `parseJSON` 作为第一个处理器时，您必须使用 `@message` 作为源字段来解析整个日志事件。在初始 JSON 解析后，您可以在后续处理器中操作特定字段。以下示例创建了一个包含 `parseJSON` 和 `addKeys` 处理器的转换器：

  ```
   aws logs put-transformer \
    --transformer-config '[{"parseJSON":{"source":"@message"}},{"addKeys":{"entries":[{"key":"metadata.transformed_in","value":"CloudWatchLogs"},{"key":"feature","value":"Transformation"}]}},{"trimString":{"withKeys":["status"]}}]' \
    --log-group-identifier my-log-group-name
  ```