각 IAM 권한에는 type 속성이 포함되며 그 값은 네 가지 값(ADMIN_READ, ADMIN_WRITE, DATA_READ, DATA_WRITE) 중 하나일 수 있는 열거형입니다. 메서드를 호출하면 Cloud Bigtable API에서 감사 로그를 생성합니다. 이 로그의 카테고리는 메서드를 수행하는 데 필요한 권한의 type 속성에 종속됩니다.
DATA_READ, DATA_WRITE, ADMIN_READ의 type 속성 값을 가진 IAM 권한이 필요한 메서드는 데이터 액세스 감사 로그를 생성합니다.
type 속성 값이 ADMIN_WRITE인 IAM 권한이 필요한 메서드는 관리자 활동 감사 로그를 생성합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eCloud Bigtable API audit logs record administrative and data access activities within Google Cloud resources, and they are identifiable by the service name \u003ccode\u003ebigtable.googleapis.com\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAudit logs are categorized as either Data Access or Admin Activity, determined by the IAM permission type required for the method, where \u003ccode\u003eADMIN_WRITE\u003c/code\u003e generates Admin Activity logs, and \u003ccode\u003eDATA_READ\u003c/code\u003e, \u003ccode\u003eDATA_WRITE\u003c/code\u003e, or \u003ccode\u003eADMIN_READ\u003c/code\u003e generate Data Access logs.\u003c/p\u003e\n"],["\u003cp\u003eMethods associated with the \u003ccode\u003egoogle.bigtable.v2.Bigtable\u003c/code\u003e API are detailed with their specific audit log type, required permissions, and whether they are streaming operations.\u003c/p\u003e\n"],["\u003cp\u003eCertain high-volume or low-value methods, such as \u003ccode\u003egrpc.lookup.v1.RouteLookupService.RouteLookup\u003c/code\u003e, do not generate audit logs to avoid excessive logging.\u003c/p\u003e\n"]]],[],null,["# Cloud Bigtable API audit logging\n================================\n\nThis document describes audit logging for Cloud Bigtable API. Google Cloud services\ngenerate audit logs that record administrative and access activities within your Google Cloud resources.\nFor more information about Cloud Audit Logs, see the following:\n\n- [Types of audit logs](/logging/docs/audit#types)\n- [Audit log entry structure](/logging/docs/audit#audit_log_entry_structure)\n- [Storing and routing audit logs](/logging/docs/audit#storing_and_routing_audit_logs)\n- [Cloud Logging pricing summary](/stackdriver/pricing#logs-pricing-summary)\n- [Enable Data Access audit logs](/logging/docs/audit/configure-data-access)\n\n\u003cbr /\u003e\n\nNotes\n-----\n\nWhen a log entry exceeds the [size limit](/logging/docs/audit#quotas), Cloud Logging splits that entry and distributes the data across several entries. To learn how to identify and reassemble split audit logs, see [Split audit log entries](/logging/docs/audit/split-logs).\n\nService name\n------------\n\nCloud Bigtable API audit logs use the service name `bigtable.googleapis.com`.\nFilter for this service: \n\n```gdscript\n protoPayload.serviceName=\"bigtable.googleapis.com\"\n \n```\n\n\u003cbr /\u003e\n\nMethods by permission type\n--------------------------\n\n| For details about which fields are logged for Data Access audit logging, see [Audit log fields](/bigtable/docs/audit-log-fields). Before you enable Data Access audit logging, read [Managing Costs](/bigtable/docs/audit-log-estimate-costs).\n\nEach IAM permission has a `type` property, whose value is an enum\nthat can be one of four values: `ADMIN_READ`, `ADMIN_WRITE`,\n`DATA_READ`, or `DATA_WRITE`. When you call a method,\nCloud Bigtable API generates an audit log whose category is dependent on the\n`type` property of the permission required to perform the method.\n\nMethods that require an IAM permission with the `type` property value\nof `DATA_READ`, `DATA_WRITE`, or `ADMIN_READ` generate\n[Data Access](/logging/docs/audit#data-access) audit logs.\n\nMethods that require an IAM permission with the `type` property value\nof `ADMIN_WRITE` generate\n[Admin Activity](/logging/docs/audit#admin-activity) audit logs.\n\nAPI interface audit logs\n------------------------\n\nFor information about how and which permissions are evaluated for each method,\nsee the Identity and Access Management documentation for Cloud Bigtable API.\n\n### `google.bigtable.v2.Bigtable`\n\nThe following audit logs are associated with methods belonging to\n`google.bigtable.v2.Bigtable`.\n\n#### `CheckAndMutateRow`\n\n- **Method** : `google.bigtable.v2.Bigtable.CheckAndMutateRow` \n- **Audit log type** : [Data access](/logging/docs/audit#data-access) \n- **Permissions** :\n - `bigtable.tables.mutateRows - DATA_WRITE`\n- **Method is a long-running or streaming operation** : No. \n- **Filter for this method** : `\n protoPayload.methodName=\"google.bigtable.v2.Bigtable.CheckAndMutateRow\"\n ` \n\n#### `ExecuteQuery`\n\n- **Method** : `google.bigtable.v2.Bigtable.ExecuteQuery` \n- **Audit log type** : [Data access](/logging/docs/audit#data-access) \n- **Permissions** :\n - `bigtable.instances.executeQuery - DATA_READ`\n - `bigtable.tables.readRows - DATA_READ`\n- **Method is a long-running or streaming operation** : [**Streaming RPC**](/logging/docs/audit/understanding-audit-logs#streaming) \n- **Filter for this method** : `\n protoPayload.methodName=\"google.bigtable.v2.Bigtable.ExecuteQuery\"\n ` \n\n#### `GenerateInitialChangeStreamPartitions`\n\n- **Method** : `google.bigtable.v2.Bigtable.GenerateInitialChangeStreamPartitions` \n- **Audit log type** : [Data access](/logging/docs/audit#data-access) \n- **Permissions** :\n - `bigtable.tables.readRows - DATA_READ`\n- **Method is a long-running or streaming operation** : [**Streaming RPC**](/logging/docs/audit/understanding-audit-logs#streaming) \n- **Filter for this method** : `\n protoPayload.methodName=\"google.bigtable.v2.Bigtable.GenerateInitialChangeStreamPartitions\"\n ` \n\n#### `MutateRow`\n\n- **Method** : `google.bigtable.v2.Bigtable.MutateRow` \n- **Audit log type** : [Data access](/logging/docs/audit#data-access) \n- **Permissions** :\n - `bigtable.tables.mutateRows - DATA_WRITE`\n- **Method is a long-running or streaming operation** : No. \n- **Filter for this method** : `\n protoPayload.methodName=\"google.bigtable.v2.Bigtable.MutateRow\"\n ` \n\n#### `MutateRows`\n\n- **Method** : `google.bigtable.v2.Bigtable.MutateRows` \n- **Audit log type** : [Data access](/logging/docs/audit#data-access) \n- **Permissions** :\n - `bigtable.tables.mutateRows - DATA_WRITE`\n- **Method is a long-running or streaming operation** : [**Streaming RPC**](/logging/docs/audit/understanding-audit-logs#streaming) \n- **Filter for this method** : `\n protoPayload.methodName=\"google.bigtable.v2.Bigtable.MutateRows\"\n ` \n\n#### `PingAndWarm`\n\n- **Method** : `google.bigtable.v2.Bigtable.PingAndWarm` \n- **Audit log type** : [Data access](/logging/docs/audit#data-access) \n- **Permissions** :\n - `bigtable.instances.ping - ADMIN_READ`\n- **Method is a long-running or streaming operation** : No. \n- **Filter for this method** : `\n protoPayload.methodName=\"google.bigtable.v2.Bigtable.PingAndWarm\"\n ` \n\n#### `PrepareQuery`\n\n- **Method** : `google.bigtable.v2.Bigtable.PrepareQuery` \n- **Audit log type** : [Data access](/logging/docs/audit#data-access) \n- **Permissions** :\n - `bigtable.instances.executeQuery - DATA_READ`\n- **Method is a long-running or streaming operation** : No. \n- **Filter for this method** : `\n protoPayload.methodName=\"google.bigtable.v2.Bigtable.PrepareQuery\"\n ` \n\n#### `ReadChangeStream`\n\n- **Method** : `google.bigtable.v2.Bigtable.ReadChangeStream` \n- **Audit log type** : [Data access](/logging/docs/audit#data-access) \n- **Permissions** :\n - `bigtable.tables.readRows - DATA_READ`\n- **Method is a long-running or streaming operation** : [**Streaming RPC**](/logging/docs/audit/understanding-audit-logs#streaming) \n- **Filter for this method** : `\n protoPayload.methodName=\"google.bigtable.v2.Bigtable.ReadChangeStream\"\n ` \n\n#### `ReadModifyWriteRow`\n\n- **Method** : `google.bigtable.v2.Bigtable.ReadModifyWriteRow` \n- **Audit log type** : [Data access](/logging/docs/audit#data-access) \n- **Permissions** :\n - `bigtable.tables.mutateRows - DATA_WRITE`\n - `bigtable.tables.readRows - DATA_READ`\n- **Method is a long-running or streaming operation** : No. \n- **Filter for this method** : `\n protoPayload.methodName=\"google.bigtable.v2.Bigtable.ReadModifyWriteRow\"\n ` \n\n#### `ReadRows`\n\n- **Method** : `google.bigtable.v2.Bigtable.ReadRows` \n- **Audit log type** : [Data access](/logging/docs/audit#data-access) \n- **Permissions** :\n - `bigtable.tables.readRows - DATA_READ`\n- **Method is a long-running or streaming operation** : [**Streaming RPC**](/logging/docs/audit/understanding-audit-logs#streaming) \n- **Filter for this method** : `\n protoPayload.methodName=\"google.bigtable.v2.Bigtable.ReadRows\"\n ` \n\n#### `SampleRowKeys`\n\n- **Method** : `google.bigtable.v2.Bigtable.SampleRowKeys` \n- **Audit log type** : [Data access](/logging/docs/audit#data-access) \n- **Permissions** :\n - `bigtable.tables.sampleRowKeys - DATA_READ`\n- **Method is a long-running or streaming operation** : [**Streaming RPC**](/logging/docs/audit/understanding-audit-logs#streaming) \n- **Filter for this method** : `\n protoPayload.methodName=\"google.bigtable.v2.Bigtable.SampleRowKeys\"\n ` \n\nMethods that don't produce audit logs\n-------------------------------------\n\nA method might not produce audit logs for one or more of the following\nreasons:\n\n- It is a high volume method involving significant log generation and storage costs.\n- It has low auditing value.\n- Another audit or platform log already provides method coverage.\n\n\u003cbr /\u003e\n\nThe following methods don't produce audit logs:\n\n- `grpc.lookup.v1.RouteLookupService.RouteLookup`"]]