监控您的 S3 文件网关FSx - AWS Storage Gatewa
获取 S3 文件网关FSx 运行状况日志使用亚马逊 CloudWatch 指标收到有关文件操作的通知了解网关指标了解文件共享指标了解 S3 文件网关FSx 文件网审核日志

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

监控您的 S3 文件网关FSx

您可以使用 Amazon CloudWatch 指标和审计日志监控您 AWS Storage Gateway 的 S3 FSx 文件网关和中的相关资源。您还可以使用 “ CloudWatch 事件” 在文件操作完成后收到通知。

使用日志组获取 S3 FSx 文件网关运行状况日志 CloudWatch

您可以使用 Amaz CloudWatch on Logs 来获取有关 S3 文件网关和相关资源运行状况的信息。您可以使用日志来监控网关遇到的错误。此外，您还可以使用 Amazon CloudWatch 订阅筛选器实时自动处理日志信息。有关更多信息，请参阅 Amazon CloudWatch 用户指南中的通过订阅实时处理日志数据。

例如，您可以配置一个 CloudWatch 日志组来监控您的网关，并在您的 S3 文件网关无法将文件上传到 Amazon S3 存储桶时收到通知。您可以在激活网关时配置组，也可以在网关激活并启动并运行之后配置组。有关如何在激活网关时配置 CloudWatch 日志组的信息，请参阅配置您的亚马逊 S3 文件网关。有关 CloudWatch 日志组的一般信息，请参阅 Amazon CloudWatch 用户指南中的使用日志组和日志流。

以下是 S3 文件网关报告的错误示例。

{
    "severity": "ERROR",
    "bucket": "bucket-smb-share2",
    "roleArn": "arn:aws:iam::123456789012:role/amzn-s3-demo-bucket",
    "source": "share-E1A2B34C",
    "type": "InaccessibleStorageClass",
    "operation": "S3Upload",
    "key": "myFolder/myFile.text",
    "gateway": "sgw-B1D123D4",
    "timestamp": "1565740862516"
}

此错误意味着 S3 文件网关无法将对象上传到 Amazon S3，因为它已从 Amazon S3 标准存储类过渡myFolder/myFile.text到 S3 Glacier 灵活检索或 S3 Glacier Deep Archive Deep Archive 存储类别。

在前面的网关运行状况日志中，这些项目指定了给定的信息：

  • source: share-E1A2B34C 指示遇到此错误的文件共享。

  • "type": "InaccessibleStorageClass" 指示所发生的错误的类型。在本例中，当网关尝试将指定对象上传到 Amazon S3 或从 Amazon S3 读取数据时，就会遇到此错误。但是，在本例中，该对象已过渡到 Amazon S3 Glacier。的值"type"可以是 S3 文件网关遇到的任何错误。有关可能错误的列表，请参阅 故障排除：文件网关问题。

  • "operation": "S3Upload"表示此错误是在网关尝试将此对象上传到 S3 时发生的。

  • "key": "myFolder/myFile.text" 指示导致故障的对象。

  • gateway": "sgw-B1D123D4表示遇到此错误的 S3 文件网关。

  • "timestamp": "1565740862516"表示错误发生的时间。

有关如何对 S3 文件网关网关可能报告的错误进行故障排除的信息，请参阅故障排除：文件网关问题。

在网关激活后配置 CloudWatch 日志组

以下过程说明如何在激活网关后配置 CloudWatch 日志组。

配置 CloudWatch 日志组以使用您的 S3 文件网关FSx

  1. 登录 AWS Management Console 并在https://console.aws.amazon.com/storagegateway/家中打开 Storage Gateway 控制台。

  2. 在导航窗格中，选择 Gateways，然后选择要为其配置 CloudWatch 日志组的网关。

  3. 对于操作，请选择编辑网关信息。

  4. 在 “选择如何设置日志组” 中，选择以下选项之一：

    • 创建新的日志组以创建新的 CloudWatch日志组。

    • 使用现有日志组使用已存在的 CloudWatch 日志组。

      从现有日志组列表中选择一个日志组。

    • 如果您不想使用@@ 日志组监控网关，请停用 CloudWatch 日志记录。

  5. 选择保存更改。

  6. 要查看网关的运行状况日志，请执行以下操作：

    1. 在导航窗格中，选择 Gateways，然后选择您为其配置 CloudWatch 日志组的网关。

    2. 选择 “详细信息” 选项卡，然后在 “Healt h Logs” 下，选择 “CloudWatch日志”。日志组详细信息页面将在 CloudWatch 控制台中打开。

使用亚马逊 CloudWatch 指标

您可以使用 AWS Management Console 或 CloudWatch API 获取 S3 文件网关FSx 的监控数据。控制台根据来自 CloudWatch API 的原始数据显示一系列图表。 CloudWatch API 也可以通过其中一个AWS SDKs或 Amazon CloudWatch API 工具来使用。根据您的需求差异，您可能倾向于使用控制台中显示的图表，也可能倾向于检索自 API 的图表。

无论使用哪种方法处理指标，都必须指定以下信息：

  • 要使用的指标维度。维度 是帮助您对某指标进行唯一标识的名称/值对。Storage Gateway 的维度为 GatewayId 和 GatewayName。在 CloudWatch 控制台中，您可以使用Gateway Metrics视图来选择网关特定的维度。有关尺寸的更多信息，请参阅 Amazon CloudWatch 用户指南中的尺寸。

  • 指标名称，如 ReadBytes。

下表总结了可供您使用的 Storage Gateway 指标数据的类型。

Amazon CloudWatch 命名空间 维度 描述
AWS/StorageGateway GatewayId, GatewayName

这些维度筛选描述网关各个方面的指标数据。您可以通过指定和GatewayName维度来识别要使用的 S3 FSx 文件网关。GatewayId

网关的吞吐量和延迟数据基于网关中的所有文件共享。

数据在 5 分钟期间内自动可用，无需收费。

网关和文件指标的使用方式类似于其他服务指标。您可以在下面所列的 CloudWatch 文档中找到一个有关某些最常见的指标任务的讨论：

收到有关文件操作的通知

文件操作完成后，Storage Gateway 可以启动以下 CloudWatch 事件：

  • 当网关完成将您的文件从文件共享异步上传到 Amazon S3 时，您会收到通知。使用NotificationPolicy参数请求文件上传通知。每完成向 Amazon S3 上传文件，系统都会发送一条通知。有关更多信息，请参阅 收到文件上传通知。

  • 当网关完成将您的工作文件集从文件共享异步上传到 Amazon S3 时，您会收到通知。使用 NotifyWhenUploadedAPI 操作请求工作文件集上传通知。当工作文件集中的所有文件都已上传到 Amazon S3 时，系统会发送通知。有关更多信息，请参阅 正在获取工作文件集上传通知。

  • 您可以在网关完成为 S3 存储桶刷新缓存后获得通知。当您通过 Storage Gateway 控制台或 API 调用RefreshCache操作时，请在操作完成后订阅通知。有关更多信息，请参阅 正在获取刷新缓存通知。

当您请求的文件操作完成后，Storage Gateway 会通过 “ CloudWatch 事件” 向您发送通知。您可以将 CloudWatch 事件配置为通过事件目标（例如 Amazon SNS、Amazon SQS 或函数）发送通知。 AWS Lambda 例如，您可以将 Amazon SNS 目标配置为向亚马逊 SNS 消费者发送通知，例如电子邮件或短信。有关 CloudWatch 事件的信息，请参阅什么是 CloudWatch 事件？

设置 CloudWatch 事件通知

  1. 创建目标，例如亚马逊 SNS 主题或 Lambda 函数，以便在您在 Storage Gateway 中请求的事件发生时调用。

  2. 在 CloudWatch 事件控制台中创建规则，以便根据 Storage Gateway 中的事件调用目标。

  3. 在规则中，为事件类型创建事件模式。事件与此规则模式匹配时发送的通知。

  4. 选择目标并配置设置。

以下示例显示了在指定网关和指定 AWS 区域中启动指定事件类型的规则。例如，您可以指定 Storage Gateway File Upload Event 作为事件类型。

{
   "source":[
      "aws.storagegateway"
   ],
   "resources":[
      "arn:aws:storagegateway:AWS Region:account-id
                 :gateway/gateway-id"
   ],
   "detail-type":[
      "Event type"
   ]
}

有关如何使用 CloudWatch 事件规则的信息，请参阅 Amazon Events 用户指南中的创建在事件上触发 CloudWatch 的事件规则。 CloudWatch

收到文件上传通知

您可以使用文件上传通知的用例有两种：

  • 要在云端自动处理上传的文件，您可以调用NotificationPolicy参数并取回通知 ID。文件上传后出现的通知与 API 返回的通知编号相同。如果您将此通知 ID 映射到跟踪您正在上传的文件列表，则可以在生成具有相同 ID 的事件 AWS 时启动对上传文件的处理。

  • 对于内容分发用例，您可以将两个 S3 文件网关映射到同一 Amazon S3 存储桶。Gateway1 的文件共享客户端可以将新文件上传到 Amazon S3，这些文件由 Gateway2 上的文件共享客户端读取。这些文件上传到 Amazon S3，但对于 Gateway2 不可见，因为它使用 Amazon S3 中本地缓存的文件版本。要使文件在 Gateway2 中可见，您可以使用NotificationPolicy参数请求来自 Gateway1 的文件上传通知，以便在文件上传完成时通知您。然后，您可以使用 CloudWatch 事件在 Gateway2 上自动发出文件共享RefreshCache请求。RefreshCache请求完成后，新文件将显示在 Gateway2 中。

例 示例-文件上传通知

以下示例显示了当事件与您创建的规则匹配 CloudWatch 时发送给您的文件上传通知。此通知采用 JSON 格式。您可以将此通知配置为以文本消息的形式传输到目标。detail-type 为 Storage Gateway Object Upload Event。

{
    "version": "0",
    "id": "2649b160-d59d-c97f-3f64-8aaa9ea6aed3",
    "detail-type": "Storage Gateway Object Upload Event",
    "source": "aws.storagegateway",
    "account": "123456789012",
    "time": "2020-11-05T12:34:56Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:storagegateway:us-east-1:123456789011:share/share-F123D451",
        "arn:aws:storagegateway:us-east-1:123456789011:gateway/sgw-712345DA",
        "arn:aws:s3:::do-not-delete-bucket"
    ],
    "detail": {
        "object-size": 1024,
        "modification-time": "2020-01-05T12:30:00Z",
        "object-key": "my-file.txt",
        "event-type": "object-upload-complete",        
        "prefix": "prefix/",
        "bucket-name": "amzn-s3-demo-bucket",  
    }
}

字段名称

描述

version

当前的 IAM 策略版本。

id

标识 IAM 策略的 ID。

detail-type

对发起已发送通知的事件的描述。

源

作为请求和通知来源的 AWS 服务。

账户

生成请求和通知的 AWS 账户的 ID。

时间

何时请求将文件上传到 Amazon S3。

区域

发送请求和通知的 AWS 区域。

resources

该策略适用的 Storage Gateway 资源。

对象大小

对象的大小（以字节为单位）。

修改时间

客户端修改文件的时间。

对象键

文件的路径。

event-type

启动通知 CloudWatch 的事件。

prefix

S3 存储桶的前缀名称。

bucket-name

S3 桶的名称。

正在获取工作文件集上传通知

在两种用例中，您可以使用工作文件集上传通知：

  • 要在云端自动处理上传的文件，您可以调用 NotifyWhenUploaded API 并取回通知 ID。上传工作文件集时出现的通知与 API 返回的通知 ID 相同。如果将此通知 ID 映射到跟踪正在上传的文件列表，则可以在生成具有相同 ID 的事件 AWS 时启动对上传的工作文件集的处理。

  • 对于内容分发用例，您可以将两个 S3 文件网关映射到同一 Amazon S3 存储桶。Gateway1 的文件共享客户端可以将新文件上传到 Amazon S3，文件共享客户端在 Gateway2 上读取这些文件。文件上传到 Amazon S3，但是 Gateway2 无法看到这些文件，因为它在 S3 中使用本地缓存的文件版本。要使文件在 Gateway2 中可见，请使用 NotifyWhenUploadedAPI 操作请求来自 Gateway1 的文件上传通知，以便在工作文件集的上传完成时通知您。然后，您可以使用 CloudWatch 事件在 Gateway2 上自动发出文件共享RefreshCache请求。RefreshCache请求完成后，新文件将显示在 Gateway2 中。此操作不会将文件导入网关缓存存储空间。它仅更新缓存的清单，以反映 S3 存储桶中对象清单的变化。

例 示例-工作文件集上传通知

以下示例显示了一个有效的文件集上传通知，当事件与您创建的规则匹配 CloudWatch 时，该通知将通过该通知发送给您。此通知采用 JSON 格式。您可以将此通知配置为以文本消息的形式传输到目标。detail-type 为 Storage Gateway File Upload Event。

{
    "version": "2012-10-17",
    "id": "2649b160-d59d-c97f-3f64-8aaa9ea6aed3",
    "detail-type": "Storage Gateway File Upload Event",
    "source": "aws.storagegateway",
    "account": "123456789012",
    "time": "2017-11-06T21:34:42Z",
    "region": "us-east-2",
    "resources": [
        "arn:aws:storagegateway:us-east-2:123456789011:share/share-F123D451",
        "arn:aws:storagegateway:us-east-2:123456789011:gateway/sgw-712345DA"
    ],
    "detail": {
        "event-type": "upload-complete",
        "notification-id": "11b3106b-a18a-4890-9d47-a1a755ef5e47",
        "request-received": "2018-02-06T21:34:42Z",
        "completed": "2018-02-06T21:34:53Z"
    }
}

字段名称

描述

version

当前的 IAM 策略版本。

id

标识 IAM 策略的 ID。

detail-type

对发起已发送通知的事件的描述。

源

作为请求和通知来源的 AWS 服务。

账户

生成请求和通知的 AWS 账户的 ID。

时间

何时请求将文件上传到 Amazon S3。

区域

发送请求和通知的 AWS 区域。

resources

该策略适用的 Storage Gateway 资源。

event-type

启动通知 CloudWatch 的事件。

notification-id

为发送的通知随机生成的 ID。该 ID 采用 UUID 格式。这是在调用 NotifyWhenUploaded 时返回的通知 ID。

request-received

网关收到 NotifyWhenUploaded 请求的时间。

completed

当工作集中的所有文件都上传到 Amazon S3 时。

正在获取刷新缓存通知

对于刷新缓存通知用例，您可以将两个 S3 文件网关映射到同一 Amazon S3 存储桶，Gateway1 的 NFS 客户端将新文件上传到 S3 存储桶。文件会上传到 Amazon S3，但在您刷新缓存之前，它们不会出现在 Gateway2 中。这是因为 Gateway2 使用了 Amazon S3 中文件的本地缓存版本。当刷新缓存完成时，您可能希望对 Gateway2 中的文件执行某项操作。大文件可能需要一段时间才能显示在 Gateway2 中，因此您可能需要在缓存刷新完成后收到通知。您可以从 Gateway2 请求刷新缓存通知，以在所有文件都在 Gateway2 中可见时通知您。

例 示例-刷新缓存通知

以下示例显示了当事件与您创建的规则匹配 CloudWatch 时发送给您的刷新缓存通知。此通知采用 JSON 格式。您可以将此通知配置为以文本消息的形式传输到目标。detail-type 为 Storage Gateway Refresh Cache Event。

{
    "version": "2012-10-17",
    "id": "2649b160-d59d-c97f-3f64-8aaa9ea6aed3",
    "detail-type": "Storage Gateway Refresh Cache Event",
    "source": "aws.storagegateway",
    "account": "209870788375",
    "time": "2017-11-06T21:34:42Z",
    "region": "us-east-2",
    "resources": [
        "arn:aws:storagegateway:us-east-2:123456789011:share/share-F123D451",
        "arn:aws:storagegateway:us-east-2:123456789011:gateway/sgw-712345DA"
    ],
    "detail": {
        "event-type": "refresh-complete",
        "notification-id": "1c14106b-a18a-4890-9d47-a1a755ef5e47",
        "started": "2018-02-06T21:34:42Z",
        "completed": "2018-02-06T21:34:53Z",
        "folderList": [
            "/"
        ]
    }
}

字段名称

描述

version

当前的 IAM 策略版本。

id

标识 IAM 策略的 ID。

detail-type

对发起已发送通知的事件类型的描述。

源

作为请求和通知来源的 AWS 服务。

账户

生成请求和通知的 AWS 账户的 ID。

时间

刷新工作集中的文件的请求的发出时间。

区域

发送请求和通知的 AWS 区域。

resources

该策略适用的 Storage Gateway 资源。

event-type

启动通知 CloudWatch 的事件。

notification-id

为发送的通知随机生成的 ID。该 ID 采用 UUID 格式。这是在调用 RefreshCache 时返回的通知 ID。

started

当网关收到RefreshCache请求并开始刷新时。

completed

完成工作集刷新的时间。

folderList

在缓存中刷新的文件夹的逗号分隔路径列表。默认为 ["/"]。

了解网关指标

下表描述了涵盖 S3 文件网关的指标。每个网关都有一组与之关联的指标。某些特定于网关的指标与某些指标同名。 file-share-specific这些指标代表相同类型的衡量标准，但范围仅限于网关而不是文件共享。

使用特定指标时，请务必指定是要使用网关还是文件共享。具体而言，在使用网关指标时，必须Gateway Name为要查看其指标数据的网关指定。有关更多信息，请参阅 使用亚马逊 CloudWatch 指标。

注意

某些指标仅在最近的监控期内生成了新数据时才会返回数据点。

下表描述了可用于获取有关 S3 文件网关网关的信息的指标。

指标 描述
AuditNotifications

该指标报告发出的审计日志数量。

单位：计数
AvailabilityNotifications

该指标报告了网关在报告期内生成的与可用性相关的运行状况通知的数量。

单位：计数
CacheFileSize

该指标跟踪网关缓存中文件的大小。

使用此指标和Average统计数据来衡量网关缓存中文件的平均大小。使用此指标和Max统计数据来衡量网关缓存中文件的最大大小。

单位：字节
CacheFree

该指标报告网关缓存中的可用字节数。

单位：字节
CacheHitPercent

来自网关的应用程序读取操作中由缓存提供的百分比。样本在报告周期结束时采用。

当没有来自网关的应用程序读取操作时，此指标会报告 100%。

单位：百分比
CachePercentDirty

网关缓存中尚未持久化的总体百分比。 AWS样本在报告周期结束时采用。

将此指标与Sum统计数据结合使用。

理想情况下，该指标应保持在较低水平。

单位：百分比
CachePercentUsed

整个网关使用的数据缓存百分比。样本在报告周期结束时采用。

单位：百分比
CacheUsed

该指标报告网关缓存中已使用的字节数。

单位：字节
CloudBytesDownloaded

在报告期内，网关从中 AWS 下载的总字节数。

将此指标与 Sum 统计数据结合使用可测量吞吐量，将其与 Samples 统计数据结合使用可测量 IOPS。

单位：字节
CloudBytesUploaded

网关在报告期内上传到的 AWS 总字节数。

将此指标与Sum统计数据结合使用以衡量吞吐量，将此指标与Samples统计数据结合使用以衡量每秒 input/output 操作数 (IOPS)。

单位：字节
FilesFailingUpload

该指标跟踪未能上传到的文件数量 AWS。这些文件将生成健康通知，其中包含有关该问题的更多信息。

将此指标与Sum统计数据结合使用，可以显示当前无法上传到的文件数量 AWS。

单位：计数
FileSharesUnavailable

该指标提供了此网关上处于不可用状态的文件共享的数量。

如果此指标报告任何文件共享不可用，则网关很可能存在问题，这可能会导致您的工作流程中断。建议在此指标报告非零值时创建警报。

单位：计数
FilesRenamed

该指标跟踪报告期内重命名的文件数量。

单位：计数
HealthNotifications

该指标报告了该网关在报告期内生成的运行状况通知的数量。

单位：计数
IndexEvictions

该指标报告了从文件元数据的缓存索引中移出元数据以便为新条目腾出空间的文件数量。网关维护此元数据索引，该索引是根据需要从 AWS 云端填充的。

单位：计数
IndexFetches

该指标报告已提取元数据的文件数量。网关维护文件元数据的缓存索引，该索引是根据需要从 AWS 云端填充的。

单位：计数
IoWaitPercent

此指标报告 CPU 等待本地磁盘响应的时间百分比。

单位：百分比
MemTotalBytes

该指标报告网关上的内存总量。

单位：字节
MemUsedBytes

该指标报告网关上已使用的内存量。

单位：字节
NfsSessions

该指标报告网关上处于活动状态的 NFS 会话数量。

单位：计数
RootDiskFreeBytes

该指标报告网关根磁盘上的可用字节数。

如果此指标报告的可用空间少于 20 GB，则应增加根磁盘的大小。

要增加根磁盘的大小，可以增加虚拟机上现有根磁盘的大小。虚拟机重新启动后，网关会识别根磁盘上增加的大小。

单位：字节
S3GetObjectRequestTime

该指标报告网关完成 S3 获取对象请求的时间。

单位：毫秒
S3PutObjectRequestTime

该指标报告网关完成 S3 放置对象请求的时间。

单位：毫秒
S3UploadPartRequestTime

该指标报告网关完成 S3 上传段请求的时间。

单位：毫秒
SmbV1Sessions

该指标报告网关上处于活动状态的 SMBv1 会话数。

单位：计数
SmbV2Sessions

该指标报告网关上处于活动状态的 SMBv2 会话数。

单位：计数
SmbV3Sessions

该指标报告网关上处于活动状态的 SMBv3 会话数。

单位：计数
TotalCacheSize

该指标报告缓存的总大小。

单位：字节
UserCpuPercent

该指标报告网关处理所花费的时间百分比。

单位：百分比

了解文件共享指标

您可以在下面找到有关涵盖文件共享的 Storage Gateway 指标的信息。每个文件共享均有与其关联的一组指标。某些特定于文件共享的指标与某些特定于网关的指标同名。这些指标代表同类度量，但其范围限于文件共享。

始终在使用指标前指定要使用网关还是文件共享指标。尤其是使用文件共享指标时，您必须指定标识希望查看其指标的文件共享的 File share ID。有关更多信息，请参阅 使用亚马逊 CloudWatch 指标。

注意

某些指标仅在最近的监控期内生成了新数据时才会返回数据点。

下表描述了 Storage Gateway 指标，您可以使用这些指标来获取有关文件共享的信息。

指标 描述
CacheHitPercent

从缓存提供的文件共享中应用程序读取操作的百分比。样本在报告周期结束时采用。

当没有应用程序从文件共享中读取操作时，此指标将报告 100%。

单位：百分比
CachePercentDirty

文件共享占网关缓存中尚未持久存在的总百分比。 AWS样本在报告周期结束时采用。

将此指标与Sum统计数据结合使用。

理想情况下，该指标应保持在较低水平。

注意

使用网关的CachePercentDirty指标来查看网关缓存中尚未持久化的总体百分比。 AWS

单位：百分比
CachePercentUsed

整个网关使用的数据缓存百分比。样本在报告周期结束时采用。此文件共享特定指标报告的值与相应的网关特定指标相同。

单位：百分比
CloudBytesUploaded

网关在报告期内上传到的 AWS 总字节数。

将此指标与 Sum 统计数据结合使用可测量吞吐量，将其与 Samples 统计数据结合使用可测量 IOPS。

单位：字节
CloudBytesDownloaded

在报告期内，网关从中 AWS 下载的总字节数。

将此指标与Sum统计数据结合使用以衡量吞吐量，将此指标与Samples统计数据结合使用以衡量每秒 input/output 操作数 (IOPS)。

单位：字节
FilesFailingUpload

该指标跟踪未能上传到的文件数量 AWS。这些文件将生成健康通知，其中包含有关该问题的更多信息。

将此指标与Sum统计数据结合使用，可以显示当前无法上传到的文件数量 AWS。

单位：计数
ReadBytes

文件共享的报告周期内从本地应用程序读取的总字节数。

将此指标与 Sum 统计数据结合使用可测量吞吐量，将其与 Samples 统计数据结合使用可测量 IOPS。

单位：字节
WriteBytes

报告周期内写入到场内应用程序的总字节数。

将此指标与 Sum 统计数据结合使用可测量吞吐量，将其与 Samples 统计数据结合使用可测量 IOPS。

单位：字节

了解 S3 文件网关FSx 文件网审核日志

Amazon S3 文件网关（S3 文件网关）审核日志为您提供有关用户访问文件共享中文件和文件夹的详细信息。您可以使用它们监控用户活动，并在识别到不当的活动模式时采取措施。

操作

下表描述了 S3 文件网关FSx 审核日志文件访问操作。

操作名称

定义

读取数据

读取文件的内容。

写入数据

更改文件的内容。

创建

创建新文件或文件夹。

重命名

重命名现有文件或文件夹。

删除

删除文件或文件夹。

写入属性

更新文件或文件夹的元数据（ACLs、所有者、群组、权限）。

Attributes

下表介绍了 S3 文件网关审核日志文件访问属性。

属性

定义
accessMode 对象的权限设置。
accountDomain（仅限中小型企业） 客户端账户所属的 Active Directory (AD) 域。
accountName（仅限中小型企业） 客户机的 Active Directory 用户名。
bucket S3 桶名称。
clientGid（仅限 NFS） 访问对象的用户组的标识符。
clientUid（仅限 NFS） 访问对象的用户的标识符。
ctime 在此时间修改对象的内容或元数据，由客户端设置。
groupId 对象群组所有者的标识符。
fileSizeInBytes 文件大小，以字节为单位，由客户端在文件创建时设置。
gateway Storage Gateway ID。
mtime 在此时间修改对象的内容，由客户端设置。
newObjectName 新对象重命名后的完整路径。
objectName 对象的完整路径。
objectType 定义对象是文件还是文件夹。
operation 对象访问操作的名称。
ownerId 对象拥有者的标识符。
securityDescriptor（仅限中小型企业） 显示在对象上设置的自由访问控制列表 (DACL)，使用 SDDL 格式。
shareName 正在访问的共享的名称。
source 所审计的文件共享的 ID。
sourceAddress 文件共享客户端计算机的 IP 地址。
status 操作的状态。仅记录成功（记录失败，但由于权限被拒绝而导致的失败除外）。
timestamp 发生操作的时间，基于网关的操作系统时间戳。
version 审计日志格式的版本。

每个操作记录的属性

下表描述了每个文件访问操作中记录的 S3 文件网关审核日志属性。

读取数据

写入数据

创建文件夹

创建文件

重命名文件/文件夹

删除文件/文件夹

写入属性（更改 ACL-仅限 SMB）

写入属性（chown）

写入属性 (chmod)

写入属性 (chgrp)
accessMode X 形 X 形 X 形
accountDomain（仅限中小型企业） X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形
accountName（仅限中小型企业） X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形
bucket X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形
clientGid（仅限 NFS） X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形
clientUid（仅限 NFS） X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形
ctime X 形 X 形
groupId X 形 X 形
fileSizeInBytes X 形
gateway X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形
mtime X 形 X 形
newObjectName X 形
objectName X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形
objectType X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形
operation X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形
ownerId X 形 X 形 X 形
securityDescriptor（仅限中小型企业） X 形 X 形
shareName X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形
source X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形
sourceAddress X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形
status X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形
timestamp X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形
version X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形 X 形