Anywhere Cache 캐시 만들기 및 관리
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이 페이지에서는 Anywhere Cache 캐시 인스턴스를 만들고 관리하는 방법을 설명합니다.

Anywhere Cache 비동기 캐시 작업에서 시작되는 장기 실행 작업을 사용하고 관리하는 방법에 관한 자세한 내용은 장기 실행 작업 사용을 참고하세요.

Anywhere Cache를 사용하기 전에 제한사항을 검토하세요.

시작하기 전에

Anywhere Cache 캐시를 만들고 관리하는 데 필요한 권한을 얻으려면 관리자에게 캐시를 만들려는 버킷에 대한 스토리지 관리자 (roles/storage.admin) IAM 역할을 부여해 달라고 요청하세요.

이 사전 정의된 역할에는 Anywhere Cache 캐시를 만들고 관리하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

Anywhere Cache 캐시를 만들고 관리하려면 다음 권한이 필요합니다.

storage.anywhereCaches.disable(캐시 사용 중지에 필요)
storage.anywhereCaches.get(캐시 가져오기에 필요)
storage.anywhereCaches.create(캐시 생성에 필요)
storage.anywhereCaches.list(캐시 목록에 필요)
storage.anywhereCaches.pause(캐시 일시중지에 필요)
storage.anywhereCaches.resume(캐시 재개에 필요)
storage.anywhereCaches.update(캐시 업데이트에 필요)

커스텀 역할로도 이러한 권한을 얻을 수 있습니다.

버킷의 역할 부여에 대한 자세한 내용은 버킷에 IAM 사용을 참조하세요.

Anywhere Cache 메서드에서 시작되는 장기 실행 작업을 관리하려면 추가 역할 및 권한이 필요할 수 있습니다. 자세한 내용은 장기 실행 작업에 필요한 역할을 참고하세요.

캐시 만들기

Terraform을 사용하여 Anywhere Cache를 만들고 관리하는 방법을 알아보려면 Terraform 문서의 google_storage_anywhere_cache 리소스를 참고하세요.

콘솔

Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.
버킷으로 이동
버킷 목록에서 데이터를 캐시하려는 버킷의 이름을 클릭합니다.
버킷 세부정보 페이지에서 구성 탭을 클릭합니다.
Anywhere Cache 섹션에서 캐시 구성을 클릭합니다.

버킷에 <your_bucket_name>의 구성 수정 페이지가 표시됩니다.
캐시 리전 섹션에서 캐시를 만들 영역이 포함된 리전을 클릭합니다.
캐시 영역 섹션에서 캐시를 만들 영역을 선택합니다. 선택한 각 영역의 캐시 TTL 및 처리 옵션을 지정합니다.
구성 저장을 클릭합니다.
대화상자가 표시되면 확인을 클릭합니다.

버킷 세부정보 페이지의 작업 탭이 열리고 여기에 캐시 생성 작업의 작업 상태가 표시됩니다.

버킷 목록 페이지에서 버킷의 캐시 상태를 직접 확인할 수도 있습니다. 그러려면 다음 지침을 완료하세요.

Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.
버킷으로 이동
열 보기 아이콘()을 클릭하고 캐시를 선택한 다음 확인을 클릭합니다.

명령줄

gcloud storage buckets anywhere-caches create 명령어를 사용합니다.

gcloud storage buckets anywhere-caches create gs://BUCKET_NAME ZONE

다음과 같이 바꿉니다.

BUCKET_NAME: 데이터를 캐시할 버킷의 이름. 예를 들면 my-bucket입니다.
ZONE: 캐시가 실행될 영역. 예를 들면 us-east1-b입니다.

한 번에 여러 개의 캐시를 만들려면 여러 영역을 지정하면 됩니다. 예를 들면 us-east1-b us-east1-c us-east1-d입니다.

캐시 생성을 더욱 세밀하게 제어하려면 다음과 같은 선택적 플래그를 설정합니다.

--ttl: 캐시의 데이터 TTL (수명)을 초 단위로 지정. 지정하지 않으면 기본값은 86400s(24시간)입니다.
--admission-policy: 데이터가 캐시에 처리되는 시점을 지정. 값은 ADMIT_ON_FIRST_MISS 또는 ADMIT_ON_SECOND_MISS일 수 있습니다. 지정하지 않으면 기본적으로 ADMIT_ON_FIRST_MISS입니다.

성공하면 이 명령어는 AnywhereCache 만들기 작업과 연결된 장기 실행 작업의 ID를 반환합니다. 장기 실행 작업에 대한 세부정보를 가져오거나 장기 실행 작업을 취소하여 AnywhereCaches Create 작업이 완료되기 전에 중지할 수 있습니다.

REST API

JSON API

Authorization 헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.

다음 정보를 포함하는 JSON 파일을 만듭니다.

{
   "zone": "ZONE",
   "ttl": "TIME_TO_LIVE",
   "admissionPolicy": "ADMISSION_POLICY"
}

다음과 같이 바꿉니다.

ZONE: 캐시가 실행될 영역. 예를 들면 us-east1-b입니다.
TIME_TO_LIVE: 캐시의 데이터 TTL(수명). 값은 1시간에서 7일 사이이며 초 단위로 지정할 수 있습니다. 지정하지 않으면 기본값은 86400s(24시간)입니다.
ADMISSION_POLICY: 데이터가 처리되는 시점을 지정하는 캐시의 허용 정책. 값은 admit-on-first-miss 또는 admit-on-second-miss일 수 있습니다. 지정하지 않으면 기본적으로 admit-on-first-miss입니다.

cURL를 사용하여 캐시 생성 요청으로 JSON API를 호출합니다.
```
curl -X POST --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches"
```
다음과 같이 바꿉니다.
- JSON_FILE_NAME: 2단계에서 만든 JSON 파일의 이름
- BUCKET_NAME: 데이터를 캐시할 버킷의 이름. 예를 들면 my-bucket입니다.

작업에 성공하면 google.longrunning.Operation가 반환됩니다. 장기 실행 작업에 대한 세부정보를 가져오거나 장기 실행 작업을 취소하여 AnywhereCaches Create 작업이 완료되기 전에 중지할 수 있습니다.

캐시 보기

콘솔

Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.
버킷으로 이동
버킷 목록에서 확인하려는 캐시와 연결된 버킷의 이름을 클릭합니다.
버킷 세부정보 페이지에서 구성 탭을 클릭합니다.
Anywhere Cache 섹션에서 Cache 필드 옆에 있는 수정을 클릭합니다.
표시되는 구성 수정 페이지에서 리전을 선택하여 리전의 영역 내 모든 캐시를 확인합니다.

그런 다음 캐시 영역 창에서 사용 가능한 각 캐시에 관한 세부정보를 볼 수 있습니다.

명령줄

gcloud storage buckets anywhere-caches describe 명령어를 사용합니다.

gcloud storage buckets anywhere-caches describe ID

다음과 같이 바꿉니다.

ID: 캐시 인스턴스의 식별자(BUCKET_NAME/ANYWHERE_CACHE_ID 형식). 예를 들면 my-bucket/us-east1-b입니다.

선택적 raw 플래그를 사용하여 표준화된 API 응답 대신 원시 API 응답을 출력합니다.

성공하면 명령어는 AnywhereCache 리소스를 반환합니다.

REST API

JSON API

Authorization 헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.

cURL를 사용하여 캐시 가져오기 요청으로 JSON API를 호출합니다.
```
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID"
```
다음과 같이 바꿉니다.
- BUCKET_NAME: 검색하려는 캐시와 연결된 버킷의 이름. 예를 들면 my-bucket입니다.
- ANYWHERE_CACHE_ID: 캐시가 위치한 영역. 예를 들면 us-east1-b입니다.

이 작업이 성공하면 AnywhereCache 리소스가 반환됩니다.

캐시 나열

콘솔

Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.
버킷으로 이동
버킷 목록에서 확인하려는 캐시와 연결된 버킷의 이름을 클릭합니다.
버킷 세부정보 페이지에서 구성 탭을 클릭합니다.
Anywhere Cache 섹션에서 Cache 필드 옆에 있는 수정을 클릭합니다.
표시되는 구성 수정 페이지에서 리전을 선택하여 해당 리전의 영역 내 모든 캐시를 확인합니다.

리전 내 영역에서 사용할 수 있는 모든 캐시가 캐시 영역 창에 표시됩니다.

명령줄

gcloud storage buckets anywhere-caches list 명령어를 사용합니다.

gcloud storage buckets anywhere-caches list gs://BUCKET_NAME

다음과 같이 바꿉니다.

BUCKET_NAME: 나열하려는 캐시와 연결된 버킷의 이름. 예를 들면 my-bucket입니다.

성공하면 명령어는 AnywhereCache 리소스 목록을 반환합니다.

원하는 경우 --raw 플래그를 사용하여 표준화된 응답 대신 원시 API 응답을 반환할 수 있습니다. 결과 페이징과 같은 등록정보 동작을 제어하는 방법에 관한 자세한 내용은 gcloud storage ls 문서를 참고하세요.

REST API

JSON API

Authorization 헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.

cURL을 사용하여 캐시 나열 요청으로 JSON API를 호출합니다.
```
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches"
```
다음과 같이 바꿉니다.
- BUCKET_NAME: 검색하려는 캐시와 연결된 버킷의 이름. 예를 들면 my-bucket입니다.
여러 캐시를 나열할 때 결과 페이지를 지정할 수 있습니다.

이 작업이 성공하면 AnywhereCache 리소스 목록이 반환됩니다. 이 응답의 구조에 관한 자세한 내용은 AnywhereCaches 목록 문서의 응답을 참고하세요.

캐시 업데이트

콘솔

Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.
버킷으로 이동
버킷 목록에서 업데이트하려는 캐시와 연결된 버킷의 이름을 클릭합니다.
버킷 세부정보 페이지에서 관측 가능성 탭을 클릭한 다음 탐색 메뉴에서 캐시를 클릭합니다.
구성 수정을 클릭합니다.
표시되는 구성 수정 페이지에서 캐시의 속성을 업데이트한 다음 저장을 클릭합니다.

명령줄

gcloud storage buckets anywhere-caches update 명령어를 사용합니다.

gcloud storage buckets anywhere-caches update ID

다음과 같이 바꿉니다.

ID: 캐시 인스턴스의 식별자(BUCKET_NAME/ANYWHERE_CACHE_ID 형식). 예를 들면 my-bucket/us-east1-b입니다.

여러 캐시를 한 번에 업데이트하려면 여러 식별자를 지정하면 됩니다. 예를 들면 my-bucket/us-east1-b my-bucket/us-east1-c입니다.

다음 플래그를 사용하여 캐시의 구성을 업데이트합니다. 플래그를 지정하지 않으면 값이 변경되지 않습니다.

--ttl: 캐시의 데이터 TTL (수명)을 초 단위로 지정.
--admission-policy: 데이터가 캐시에 처리되는 시점을 지정. 값은 ADMIT_ON_FIRST_MISS 또는 ADMIT_ON_SECOND_MISS일 수 있습니다.

성공하면 이 명령어는 AnywhereCache 업데이트 작업과 연결된 원시 장기 실행 작업의 ID를 반환합니다. 장기 실행 작업에 대한 세부정보를 가져올 수 있습니다.

REST API

JSON API

Authorization 헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.

업데이트하려는 캐시 속성에 대한 변경사항이 포함된 JSON 파일을 만듭니다.

{
   "ttl": "TIME_TO_LIVE",
   "admissionPolicy": "ADMISSION_POLICY"
}

다음과 같이 바꿉니다.

TIME_TO_LIVE: 캐시 데이터의 TTL. 값은 1시간에서 7일 사이이며 초 단위로 지정할 수 있습니다. 지정하지 않으면 현재 값이 계속 사용됩니다.
ADMISSION_POLICY: 데이터가 처리되는 시점을 지정하는 캐시의 허용 정책. 값은 admit-on-first-miss 또는 admit-on-second-miss일 수 있습니다. 지정하지 않으면 현재 값이 계속 사용됩니다.

다음 예에서는 캐시의 TTL을 2일로 업데이트하고 두 번째 누락 시 데이터를 처리하도록 허용 정책을 업데이트합니다.

{
   "ttl": "172800s",
   "admissionPolicy": "admit-on-second-miss"
}

새 속성을 적용하려면 cURL를 사용하여 캐시 업데이트 요청과 함께 JSON API를 호출합니다.
```
curl -X PATCH --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID"
```
다음과 같이 바꿉니다.
- JSON_FILE_NAME: 2단계에서 만든 JSON 파일의 이름
- BUCKET_NAME: 업데이트하려는 캐시와 연결된 버킷의 이름. 예를 들면 my-bucket입니다.
- ANYWHERE_CACHE_ID: 캐시의 식별자. 예를 들면 us-east1-b입니다.

작업에 성공하면 google.longrunning.Operation가 반환됩니다. 장기 실행 작업에 대한 세부정보를 가져올 수 있습니다.

캐시 일시중지

콘솔

Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.
버킷으로 이동
버킷 목록에서 일시중지하려는 캐시와 연결된 버킷의 이름을 클릭합니다.
버킷 세부정보 페이지에서 관측 가능성 탭을 클릭한 다음 탐색 메뉴에서 캐시를 클릭합니다.
캐시 일시중지/재개를 클릭합니다.
표시되는 창에서 캐시 일시중지 전환 버튼을 클릭합니다.
일시중지/재개를 클릭합니다.
대화상자가 표시되면 확인을 클릭합니다.

명령줄

gcloud storage buckets anywhere-caches pause 명령어를 사용합니다.

gcloud storage buckets anywhere-caches pause ID

다음과 같이 바꿉니다.

ID: 캐시 인스턴스의 식별자(BUCKET_NAME/ANYWHERE_CACHE_ID 형식). 예를 들면 my-bucket/us-east1-b입니다.

여러 캐시를 한 번에 일시중지하려면 식별자를 여러 개 지정하면 됩니다. 예를 들면 my-bucket/us-east1-b my-bucket/us-east1-c입니다.

성공하면 명령어에서 성공 메시지를 반환합니다.

REST API

JSON API

Authorization 헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.

cURL를 사용하여 캐시 일시중지 요청으로 JSON API를 호출합니다.
```
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID/pause"
```
다음과 같이 바꿉니다.
- BUCKET_NAME: 일시중지하려는 캐시와 연결된 버킷의 이름. 예를 들면 my-bucket입니다.
- ANYWHERE_CACHE_ID: 캐시의 식별자. 예를 들면 us-east1-b입니다.

성공하면 작업은 형식이 지정된 AnywhereCache 리소스를 반환합니다.

캐시 재개

콘솔

일시중지된 캐시를 재개하려면 다음 안내를 완료하세요.

Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.
버킷으로 이동
버킷 목록에서 재개할 캐시와 연결된 버킷의 이름을 클릭합니다.
버킷 세부정보 페이지에서 관측 가능성 탭을 클릭한 다음 탐색 메뉴에서 캐시를 클릭합니다.
캐시 일시중지/재개를 클릭합니다.
표시되는 창에서 캐시 일시중지 전환 버튼을 클릭합니다.
일시중지/재개를 클릭합니다.
대화상자가 표시되면 확인을 클릭합니다.

사용 중지된 캐시를 재개하려면 다음 안내를 완료하세요.

Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.
버킷으로 이동
버킷 목록에서 재개할 캐시와 연결된 버킷의 이름을 클릭합니다.
버킷 세부정보 페이지에서 관측 가능성 탭을 클릭한 다음 탐색 메뉴에서 캐시를 클릭합니다.
캐시 사용 중지/재개를 클릭합니다.
표시되는 창에서 캐시 사용 중지 전환 버튼을 클릭합니다.
사용 중지/재개를 클릭합니다.
대화상자가 표시되면 확인을 클릭합니다.

명령줄

gcloud storage buckets anywhere-caches resume 명령어를 사용합니다.

gcloud storage buckets anywhere-caches resume ID

다음과 같이 바꿉니다.

ID: 캐시 인스턴스의 식별자(BUCKET_NAME/ANYWHERE_CACHE_ID 형식). 예를 들면 my-bucket/us-east1-b입니다.

여러 캐시를 한 번에 재개하려면 식별자를 여러 개 지정하면 됩니다. 예를 들면 my-bucket/us-east1-b my-bucket/us-east1-c입니다.

성공하면 이 명령어는 형식이 지정된 AnywhereCache 리소스를 반환합니다.

REST API

JSON API

Authorization 헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.

cURL을 사용하여 캐시 재개 요청으로 JSON API를 호출합니다.
```
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID/resume"
```
다음과 같이 바꿉니다.
- BUCKET_NAME: 재개하려는 캐시와 연결된 버킷의 이름. 예를 들면 my-bucket입니다.
- ANYWHERE_CACHE_ID: 캐시의 식별자. 예를 들면 us-east1-b입니다.

성공하면 작업은 형식이 지정된 AnywhereCache 리소스를 반환합니다.

캐시 사용 중지

콘솔

Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.
버킷으로 이동
버킷 목록에서 사용 중지하려는 캐시와 연결된 버킷의 이름을 클릭합니다.
버킷 세부정보 페이지에서 관측 가능성 탭을 클릭한 다음 탐색 메뉴에서 캐시를 클릭합니다.
캐시 사용 중지/재개를 클릭합니다.
표시되는 창에서 캐시 사용 중지 전환 버튼을 클릭합니다.
사용 중지/재개를 클릭합니다.
대화상자가 표시되면 확인을 클릭합니다.

명령줄

gcloud storage buckets anywhere-caches disable 명령어를 사용합니다.

gcloud storage buckets anywhere-caches disable ID

다음과 같이 바꿉니다.

ID: 캐시 인스턴스의 식별자(BUCKET_NAME/ANYWHERE_CACHE_ID 형식). 예를 들면 my-bucket/us-east1-b입니다.

여러 캐시를 한 번에 사용 중지하려면 여러 식별자를 지정하면 됩니다. 예를 들면 my-bucket/us-east1-b my-bucket/us-east1-c입니다.

성공하면 이 명령어는 형식이 지정된 AnywhereCache 리소스를 반환합니다.

REST API

JSON API

Authorization 헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.

cURL를 사용하여 캐시 사용 중지 요청으로 JSON API를 호출합니다.
```
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID/disable"
```
다음과 같이 바꿉니다.
- BUCKET_NAME: 사용 중지하려는 캐시와 연결된 버킷의 이름. 예를 들면 my-bucket입니다.
- ANYWHERE_CACHE_ID: 캐시의 식별자. 예를 들면 us-east1-b입니다.

성공하면 이 명령어는 형식이 지정된 AnywhereCache 리소스를 반환합니다.

캐시 성능 모니터링

Google Cloud 콘솔의 Cloud Storage 섹션에는 측정항목을 사용하여 캐시의 성능을 추적할 수 있는 모니터링 차트가 제공됩니다. 이러한 모니터링 차트는 Cloud Monitoring을 사용하여 볼 수도 있습니다.

사용 가능한 차트

차트	리소스 계층 구조 수준	설명
바이트 제거 속도	버킷	캐시에서 제거된 바이트의 비율로, 1시간마다 샘플링됩니다. 데이터를 후처리할 시간을 확보하기 위해 1시간에 한 번 이상 이 데이터가 새로고침됩니다.
바이트 제거 속도	프로젝트	버킷의 모든 캐시에서 제거된 바이트의 비율로, 1시간마다 샘플링됩니다. 데이터를 후처리할 시간을 확보하기 위해 1시간에 한 번 이상 이 데이터가 새로고침됩니다.
캐시의 바이트	버킷	캐시의 바이트 비율로, 1시간마다 샘플링됩니다. 데이터를 후처리할 시간을 확보하기 위해 1시간에 한 번 이상 이 데이터가 새로고침됩니다.
캐시의 바이트	프로젝트	버킷의 모든 캐시에서 1시간마다 샘플링된 바이트의 비율입니다. 데이터를 후처리할 시간을 확보하기 위해 1시간에 한 번 이상 이 데이터가 새로고침됩니다.
캐시 처리량 이점	프로젝트	리전의 데이터 전송 대역폭 할당량 비율, 할당량 사용량, 캐시에서 제공하는 추가 처리량 캐시에서 제공하는 추가 처리량은 할당량에 반영되지 않으므로 캐시를 사용하면 프로젝트가 할당량에서 허용하는 처리량을 초과할 수 있습니다.
적중률 작업	버킷	캐시에서 요청된 데이터를 제공하는 캐시 작업의 비율(총 캐시 대상 작업 대비, 60초마다 샘플링됨) 캐시에서 읽기가 완전히 반환되면 작업이 적중으로 집계됩니다. 캐시에서 읽기가 반환되지 않거나 캐시에서 부분적으로만 반환되는 경우 작업이 부적중으로 집계됩니다.
적중률 작업	프로젝트	버킷의 모든 캐시에서 요청된 데이터를 제공하는 캐시 작업의 비율을 총 캐시 대상 작업에 대비하여 60초마다 샘플링합니다. 캐시에서 읽기가 완전히 반환되면 작업이 적중으로 집계됩니다. 캐시에서 읽기가 반환되지 않거나 캐시에서 부분적으로만 반환되는 경우 작업이 부적중으로 집계됩니다.
적중률 바이트	버킷	캐시에서 제공되는 바이트의 비율을 총 캐시 대상 바이트에 대비하여 보여줍니다(60초마다 샘플링됨).
적중률 바이트	프로젝트	버킷의 모든 캐시에서 제공되는 바이트의 비율을 총 캐시 대상 바이트에 대비하여 보여줍니다(60초마다 샘플링됨).
수집 속도 원시 바이트	버킷	각 캐시에 수집된 원시 바이트의 속도입니다(60초마다 샘플링됨). 청구 불가능한 바이트 등 처리된 모든 바이트가 이 측정항목의 값을 계산하는 데 사용됩니다. 이 측정항목은 실시간으로 보고됩니다.
수집 속도 원시 바이트	프로젝트	버킷의 모든 캐시에 수집된 원시 바이트의 속도입니다(60초마다 샘플링됨). 청구 불가능한 바이트 등 처리된 모든 바이트가 이 측정항목의 값을 계산하는 데 사용됩니다. 이 측정항목은 실시간으로 보고됩니다.
처리량 - 캐시 적중	버킷	캐시에서 제공된 처리량으로, 60초마다 샘플링됩니다.
처리량 - 캐시 적중	프로젝트	버킷의 모든 캐시에서 제공된 처리량으로, 60초마다 샘플링됩니다.
처리량 - 캐시 부적중	버킷	캐시에서 제공되지 않은 처리량으로, 60초마다 샘플링됩니다.
처리량 - 캐시 부적중	프로젝트	버킷의 캐시에서 제공되지 않은 처리량으로, 60초마다 샘플링됩니다.

차트 액세스

모니터링 차트는 개별 버킷 또는 프로젝트 내의 모든 버킷에 대한 데이터를 캡처합니다. 차트에서 캡처하는 리소스 계층 구조 수준에 따라 차트에 액세스할 수 있는 위치가 결정됩니다.

버킷 수준 차트 액세스

Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.
버킷으로 이동
버킷 목록에서 모니터링 차트를 보려는 버킷의 이름을 클릭합니다.
버킷 세부정보 페이지에서 모니터링 가능성 탭을 클릭합니다.
탐색 메뉴에서 Anywhere Cache를 선택합니다.

모니터링 차트가 표시됩니다.

프로젝트 수준 차트 액세스

Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.
버킷으로 이동
Cloud Storage 탐색창에서 모니터링을 클릭합니다.
메뉴 바에서 Anywhere Cache를 클릭합니다.

모니터링 차트가 표시됩니다.

장기 실행 작업 사용

성공적으로 실행되면 AnywhereCaches Create 및 Update 작업이 장기 실행 작업을 시작합니다. 장기 실행 작업을 가져오고 나열하여 기본 AnywhereCaches 작업의 세부정보와 상태를 확인하거나 장기 실행 작업을 취소하여 진행 중인 기본 AnywhereCaches 작업을 취소할 수 있습니다.

Anywhere Cache에 장기 실행 작업을 사용하는 방법에 관한 자세한 내용은 장기 실행 작업 사용을 참고하세요.

다음 예는 AnywhereCaches Create 작업에서 시작된 장기 실행 작업을 보여줍니다.

done: false
kind: storage#operation
metadata:
  '@type': type.googleapis.com/google.storage.control.v2.CreateAnywhereCacheMetadata
  anywhereCacheId: us-central1-c
  zone: us-central1-c
  ttl: 172800s
  admissionPolicy: admit-on-first-miss
  commonMetadata:
    createTime: '2023-12-14T20:52:00.032Z'
    progressPercent: -1
    requestedCancellation: false
    type: create-anywhere-cache
    updateTime: '2023-12-14T20:52:00.032Z'
name: projects/_/buckets/my-bucket/operations/AULf_KhQxxsWRSn56wv4jfmn3pOu_dKTz9FoYx6S0EzMw5ssR0cXIiorCvHRwqxZnQmWj9jnGpKb3Y6iCD3XM9KLc8EHBm7uig
selfLink: https://www.googleapis.com/storage/v1/b/my-bucket/operations/AULf_KhQxxsWRSn56wv4jfmn3pOu_dKTz9FoYx6S0EzMw5ssR0cXIiorCvHRwqxZnQmWj9jnGpKb3Y6iCD3XM9KLc8EHBm7uig

재시도

비동기 AnywhereCaches API는 기본적으로 멱등성입니다. 즉, 의도치 않게 리소스를 수정할 우려 없이 비동기 AnywhereCaches API 호출을 안전하게 재시도할 수 있습니다.

예를 들어 AnywhereCaches Create 작업을 실행하여 us-central1-a에 캐시를 만들고 성공했다고 가정해 보겠습니다. 성공한 것과 동일한 영역을 사용하여 후속 AnywhereCaches Create 작업을 실행하면 요청이 이전 요청과 동일한 장기 실행 작업을 반환합니다. 이 동작은 캐시 생성 요청의 일부로 request_id를 포함하는 경우에만 발생합니다. request_id가 포함되지 않으면 이미 존재하는 캐시를 만들려고 하면 ANYWHERE_CACHE_ALREADY_EXISTS 오류가 발생합니다. request_id를 포함하는 방법에 관한 자세한 내용은 요청 중복을 참고하세요.

다음 단계

캐시를 만들 버킷 및 영역에 관한 추천 받기

Anywhere Cache 캐시 만들기 및 관리 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

시작하기 전에

필수 권한

캐시 만들기

콘솔

명령줄

REST API

JSON API

캐시 보기

콘솔

명령줄

REST API

JSON API

캐시 나열

콘솔

명령줄

REST API

JSON API

캐시 업데이트

콘솔

명령줄

REST API

JSON API

캐시 일시중지

콘솔

명령줄

REST API

JSON API

캐시 재개

콘솔

명령줄

REST API

JSON API

캐시 사용 중지

콘솔

명령줄

REST API

JSON API

캐시 성능 모니터링

사용 가능한 차트

차트 액세스

버킷 수준 차트 액세스

프로젝트 수준 차트 액세스

장기 실행 작업 사용

재시도

다음 단계

Anywhere Cache 캐시 만들기 및 관리
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.