Dialogflow 감사 로깅 정보

이 페이지에서는 Cloud 감사 로그의 일부로 Dialogflow에서 만든 감사 로그를 설명합니다.

개요

Google Cloud 서비스는 감사 로그를 작성하여 '누가, 언제, 어디서, 무엇을 했는지'라는 질문에 답하는 데 도움을 줍니다. 각 Cloud 프로젝트에는 그 프로젝트 바로 안에 있는 리소스의 감사 로그만 있습니다. 폴더, 조직, 결제 계정과 같은 다른 항목에는 각 항목 자체의 감사 로그가 있습니다.

Cloud 감사 로그의 일반적인 개요는 Cloud 감사 로그를 참조하세요. Cloud 감사 로그에 대한 자세한 내용은 감사 로그 이해를 참조하세요.

Cloud 감사 로그는 Google Cloud 프로젝트, 폴더, 조직마다 세 가지 감사 로그를 유지합니다.

  • 관리자 활동 감사 로그
  • 데이터 액세스 감사 로그
  • 시스템 이벤트 감사 로그

Dialogflow는 리소스의 구성 또는 메타데이터를 수정하는 작업을 기록하는 관리 활동 감사 로그를 작성합니다. 관리 활동 감사 로그를 중지할 수 없습니다.

명시적으로 사용 설정된 경우에만 Dialogflow는 데이터 액세스 감사 로그를 작성합니다. 데이터 액세스 감사 로그에는 리소스의 구성 또는 메타데이터를 읽는 API 호출뿐만 아니라 사용자가 제공한 리소스 데이터를 생성하거나, 수정하거나, 읽는 사용자 주도 API 호출도 포함됩니다. 공개적으로 공유(모든 사용자 또는 모든 인증 사용자가 사용 가능)되거나 Google Cloud에 로그인하지 않고도 액세스할 수 있는 리소스의 데이터 액세스 작업은 데이터 액세스 감사 로그에 기록되지 않습니다.

Dialogflow는 시스템 이벤트 감사 로그를 작성하지 않습니다.

감사되는 작업

다음은 Dialogflow의 각 감사 로그 유형에 해당하는 API 작업을 요약한 표입니다.

감사 로그 카테고리 Dialogflow 작업
관리 활동 로그 DeleteAgent
ExportAgent
GetAgent
ImportAgent
RestoreAgent
SearchAgents
SetAgent
TrainAgent
데이터 액세스 로그(ADMIN_READ) GetEntityType
ListEntityTypes
데이터 액세스 로그(DATA_READ) AnalyzeContent
CreateContext
CreateSessionEntityType
DeleteAllContexts
DeleteContext
DeleteSessionEntityType
DetectIntent
GetContext
GetDocument
GetIntent
GetKnowledgBase
GetSessionEntityType
ListContexts
ListDocuments
ListIntents
ListKnowledgeBases
ListMessages
ListSessionEntityTypes
ListSuggestions
StreamingAnalyzeContent
StreamingDetectIntent
UpdateContext
UpdateSessionEntityType
데이터 액세스 로그(DATA_WRITE) BatchCreateEntities
BatchDeleteEntities
BatchDeleteIntents
BatchUpdateEntities
BatchUpdateEntityTypes
BatchUpdateIntents
CreateDocument
CreateEntityType
CreateIntent
CreateKnowledgeBase
DeleteDocument
DeleteEntityType
DeleteIntent
DeleteKnowledgeBase
UpdateEntityType
UpdateIntent

감사 로그 형식

로그 뷰어, Cloud Logging API 또는 gcloud 명령줄 도구를 사용하여 Cloud Logging에서 확인할 수 있는 감사 로그 항목에는 다음과 같은 객체가 포함됩니다.

  • LogEntry 유형의 객체인 로그 항목 자체입니다. 유용한 필드는 다음과 같습니다.

    • logName에는 프로젝트 ID와 감사 로그 유형이 있습니다.
    • resource에는 감사 작업 대상이 있습니다.
    • timeStamp에는 감사 작업 시간이 있습니다.
    • protoPayload에는 감사 정보가 있습니다.
  • 로그 항목의 protoPayload 필드에 AuditLog 객체로 보관되는 감사 로깅 데이터입니다.

  • AuditLog 객체의 serviceData 필드에 서비스별 객체로 보관되는 서비스별 감사 정보로, 선택사항입니다. 자세한 내용은 서비스별 감사 데이터를 참조하세요.

이러한 객체의 다른 필드와 필드 해석 방법은 감사 로그 이해를 참조하세요.

로그 이름

Cloud 감사 로그 리소스 이름은 감사 로그를 소유하는 프로젝트나 다른 항목을 나타내며, 관리자 활동, 데이터 액세스 또는 시스템 이벤트 감사 로깅 데이터가 로그에 포함되었는지 여부도 나타냅니다. 예를 들어 다음은 프로젝트의 관리자 활동 감사 로그와 조직의 데이터 액세스 감사 로그 이름을 보여줍니다.

    projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity
    organizations/[ORGANIZATION_ID]/logs/cloudaudit.googleapis.com%2Fdata_access
    

서비스 이름

Dialogflow 감사 로그는 서비스 이름 dialogflow.googleapis.com을 사용합니다.

서비스 로깅에 대한 자세한 내용은 리소스에 서비스 매핑을 참조하세요.

리소스 유형

Dialogflow 감사 로그는 모든 감사 로그에 gcs_bucket 리소스 유형을 사용합니다.

전체 목록은 모니터링 리소스 유형을 참조하세요.

감사 로깅 사용 설정

관리자 활동 감사 로그는 항상 사용 설정되며 사용 중지할 수 없습니다.

데이터 액세스 감사 로그는 기본적으로 중지되어 있으며 명시적으로 사용 설정되지 않는 한 작성되지 않습니다. 단, 중지할 수 없는 BigQuery의 데이터 액세스 감사 로그는 예외입니다.

데이터 액세스 감사 로그의 일부 또는 전부를 사용 설정하는 방법은 데이터 액세스 로그 구성을 참조하세요.

개발자가 구성한 데이터 액세스 감사 로그는 Cloud Logging의 로그 가격에 영향을 줄 수 있습니다. 이 페이지의 가격 책정 섹션을 참조하세요.

감사 로그 권한

Cloud Identity and Access Management 권한과 역할에 따라 사용자가 확인하거나 내보낼 수 있는 감사 로그가 결정됩니다. 로그는 프로젝트 내에 있거나 조직, 폴더, 결제 계정과 같은 기타 항목 안에 있습니다. 자세한 내용은 역할 이해를 참조하세요.

관리자 활동 감사 로그를 확인하려면 감사 로그가 있는 프로젝트에 다음과 같은 Cloud IAM 역할 중 하나가 있어야 합니다.

데이터 액세스 감사 로그를 확인하려면 감사 로그가 있는 프로젝트에 다음 역할 중 하나가 있어야 합니다.

조직과 같이 프로젝트가 아닌 항목의 감사 로그를 사용하는 경우 프로젝트 역할을 적합한 조직 역할로 변경합니다.

로그 보기

감사 로그를 찾아서 보려면 감사 로깅 정보를 보려는 Google Cloud 프로젝트, 폴더, 조직의 식별자를 알아야 합니다. 색인 생성된 다른 LogEntry 필드(예: resource.type)를 더 구체적으로 지정할 수 있습니다. 자세한 내용은 로그 항목 빨리 찾기를 참조하세요.

감사 로그 이름은 다음과 같습니다.

       projects/project-id/logs/cloudaudit.googleapis.com%2Factivity
       projects/project-id/logs/cloudaudit.googleapis.com%2Fdata_access
       projects/project-id/logs/cloudaudit.googleapis.com%2Fsystem_event

       folders/folder-id/logs/cloudaudit.googleapis.com%2Factivity
       folders/folder-id/logs/cloudaudit.googleapis.com%2Fdata_access
       folders/folder-id/logs/cloudaudit.googleapis.com%2Fsystem_event

       organizations/organization-id/logs/cloudaudit.googleapis.com%2Factivity
       organizations/organization-id/logs/cloudaudit.googleapis.com%2Fdata_access
       organizations/organization-id/logs/cloudaudit.googleapis.com%2Fsystem_event
    

아래 예시에서는 프로젝트 수준 쿼리를 사용합니다. 조직 수준 또는 폴더 수준에서 감사 로그를 확인하려면 감사 로그 이름에 나열된 적절한 폴더 수준 또는 조직 수준의 감사 로그 이름 또는 식별자를 대체합니다.

여러 가지 방법으로 감사 로그 항목을 볼 수 있습니다.

Cloud Console

Cloud Console의 로그 뷰어를 사용하여 Google Cloud 프로젝트의 감사 로그 항목을 검색할 수 있습니다. 다음을 수행하세요.

  1. Cloud Console의 Google Cloud 작업 제품군 로깅 > 로그(로그 뷰어) 페이지로 이동합니다.

    로그 뷰어 페이지로 이동

  2. 페이지 상단에서 기존 Google Cloud 프로젝트를 선택하거나 새 프로젝트를 만듭니다.

  3. 첫 번째 드롭다운 메뉴에서 확인할 감사 로그의 리소스 유형을 선택합니다.

  4. 두 번째 드롭다운 메뉴에서 확인할 로그 유형을 선택합니다. 관리자 활동 감사 로그를 보려면 activity를, 데이터 액세스 감사 로그는 data_access를, 시스템 이벤트 로그는 system_events를 선택합니다.

    이러한 옵션 중 어느 것도 표시되지 않으면 프로젝트에 해당 유형의 감사 로그가 없다는 의미입니다.

기존 검색을 감사 로그만으로 제한하려면 다음을 수행합니다.

  1. 검색 필터 상자에서 드롭다운 화살표(▾)를 클릭하고 고급 필터로 전환을 선택합니다.

  2. 텍스트 상자가 나타나면 resource.type 줄 아래에 다음 쿼리를 추가합니다. 개발자가 제공하는 project-id가 현재 선택된 Google Cloud 프로젝트를 참조해야 하며, 그렇지 않은 경우 쿼리가 작동하지 않습니다.

            logName : "projects/project-id/logs/cloudaudit.googleapis.com"
        

    프로젝트에 사용 가능한 모든 감사 로그를 보려면 쿼리에 위에 있는 항목만 포함합니다. 쿼리에 대한 자세한 내용은 고급 로그 쿼리를 참조하세요.

API

Logging API를 사용하여 감사 로그 항목을 확인하려면 다음 안내를 따르세요.

  1. entries.list 메서드 문서의 API 사용해 보기 섹션으로 이동합니다.

  2. API 사용해 보기 양식의 요청 본문 부분에 다음을 입력합니다. 미리 채워진 양식을 클릭하면 요청 본문이 자동으로 입력되지만 각 로그 이름에 유효한 project-id를 입력해야 합니다.

              {
                "resourceNames": [
                  "projects/project-id"
                ],
                "pageSize": 5,
                "filter": "logName : projects/project-id/logs/cloudaudit.googleapis.com"
              }
        
  3. 실행을 클릭합니다.

쿼리에 대한 자세한 내용은 고급 로그 쿼리를 참조하세요.

GCLOUD

Cloud SDK에는 Cloud Logging API에 명령줄 인터페이스를 제공하는 명령어 그룹인 gcloud logging이 있습니다. 로그 항목을 읽으려면 다음 명령어를 실행합니다. 각 로그 이름에 유효한 project-id를 입력합니다.

        gcloud logging read "logName : projects/project-id/logs/cloudaudit.googleapis.com"

gcloud 명령줄 도구 사용에 대한 자세한 내용은 로그 항목 읽기를 참조하세요.

샘플 감사 로그 항목과 이 항목에서 가장 중요한 정보를 찾는 방법은 감사 로그 이해를 참조하세요.

감사 로그 내보내기

다른 종류의 로그를 내보낼 때와 같은 방법으로 감사 로그를 내보낼 수 있습니다. 로그 내보내기 방법에 대한 자세한 내용은 로그 내보내기를 참조하세요. 다음은 감사 로그를 내보내는 몇 가지 응용 방법입니다.

  • 감사 로그를 장기간 보존하거나 더 강력한 검색 기능을 사용하려면 감사 로그의 사본을 Cloud Storage, BigQuery 또는 Pub/Sub로 내보내면 됩니다. Pub/Sub를 사용하면 다른 애플리케이션, 다른 저장소, 제3자에게 내보낼 수 있습니다.

  • 조직 전체의 감사 로그를 관리하려면 조직의 일부 또는 모든 프로젝트에서 로그를 내보낼 수 있는 집계 싱크를 만들면 됩니다.

  • 사용 설정한 데이터 액세스 감사 로그 때문에 프로젝트가 로그 할당량을 초과하는 경우 데이터 액세스 감사 로그를 내보내고 Logging에서 제외할 수 있습니다. 자세한 내용은 로그 제외를 참조하세요.

가격 책정

Cloud Logging은 모든 관리자 활동 감사 로그를 비롯하여 사용 중지할 수 없는 감사 로그에 비용을 부과하지 않습니다. Cloud Logging은 사용자가 명시적으로 요청하는 데이터 액세스 감사 로그에 요금을 부과합니다.

감사 로그 가격에 대한 자세한 내용은 Google Cloud의 작업 제품군 가격 책정을 참조하세요.