데이터 상주로 애널리틱스 및 디버그 데이터 수집

개요

버전 1.13.1부터 새로 생성된 Apigee Hybrid 조직은 런타임 구성요소에서 데이터를 컨트롤 플레인에 직접 쓸 수 있는 새 데이터 파이프라인을 사용할 수 있습니다. 이전에는 이 작업이 Google Cloud 서비스에 쓸 서명된 URL을 생성하는 UDCA 구성요소를 통해 수행되었습니다. 새 파이프라인을 사용하면 Google Cloud 서비스에 업로드된 데이터를 처리하는 UDCA 및 기타 관련 구성요소가 필요하지 않습니다. Apigee Hybrid에서 데이터 상주 사용을 참조하세요.

구성

다음 안내에 따라 개별 구성요소에 새 데이터 파이프라인을 사용하도록 Hybrid를 구성할 수 있습니다.

설정 승인 흐름

새 파이프라인과 상호작용하여 데이터를 컨트롤 플레인에 내보낼 수 있는 런타임 서비스 계정의 권한을 설정합니다. 새 파이프라인에서 디버그 세션과 애널리틱스가 작동하게 하려면 이 단계가 수행해야 합니다.

curl -X  PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type:application/json" \
  "https://CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/ORG_NAME/controlPlaneAccess?update_mask=analytics_publisher_identities" \
  -d '{ "analytics_publisher_identities": ["serviceAccount:apigee-runtime@ORG_NAME.iam.gserviceaccount.com"]}'

다음과 같은 응답이 표시됩니다.

{
  "name": "organizations/newpipeline-hybrid-org/operations/8316aa78-c137-4733-92ec-cc0d2d92fd29",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/newpipeline-hybrid-org/controlPlaneAccess",
    "state": "IN_PROGRESS"
  }
}

업데이트 응답의 이름 매개변수를 사용하여 작업 상태를 확인합니다. 

curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
  -H "Content-Type:application/json"  \
  "https://CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/ORG_NAME/operations/8316aa78-c137-4733-92ec-cc0d2d92fd29"

다음과 같은 응답이 표시됩니다.

{
  "name": "organizations/newpipeline-hybrid-org/operations/8316aa78-c137-4733-92ec-cc0d2d92fd29",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/newpipeline-hybrid-org/controlPlaneAccess",
    "state": "FINISHED"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.ControlPlaneAccess",
    "name": "organizations/newpipeline-hybrid-org/controlPlaneAccess"
  }
}

조직의 ControlPlaneAccess 구성을 확인합니다.

curl "https://CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/ORG_NAME/controlPlaneAccess" \
-H "Authorization: Bearer $(gcloud auth print-access-token)"

다음과 같은 응답이 표시됩니다.

{
  "synchronizerIdentities": [
    "serviceAccount:apigee-synchronizer@newpipeline-hybrid-org.iam.gserviceaccount.com"
  ],
  "analyticsPublisherIdentities": [
    "serviceAccount:apigee-runtime@newpipeline-hybrid-org.iam.gserviceaccount.com"
  ]
}

디버그 및 애널리틱스 데이터 상주를 위해 새 파이프라인과 이전 파이프라인 간에 전환

서비스 계정에 적절한 승인이 제공되면 사용자는 Apigee 인스턴스를 전환하여 새 파이프라인을 사용할 수 있습니다. overrides.yaml에서 다음 플래그를 설정하면 됩니다. 

... rest of the overrides.yaml ...
gcp:
  projectID: PROJECT_ID
  region: ANALYTICS_REGION>  # Specifies the analytics region for the hybrid org. This attribute is
                               # the regional endpoint used to push analytics and debug data to the
                               # control plane. For example: us-central1

newDataPipeline:
  debugSession: true  # this flag enables debug session to use the new data pipeline
  analytics: true     # this flag enables analytics to use the new data pipeline

k8sCluster:
  name: CLUSTER_NAME
  region: CLUSTER_LOCATION # Must be the closest Google Cloud region to your cluster. For example, us-west1
org: ORG_NAME

... rest of the overrides.yaml ...

helm upgrade 명령어를 사용하여 이러한 변경사항을 적용합니다. 한 번에 환경 하나를 업그레이드합니다. --set env=ENV_NAME으로 환경을 지정합니다.

helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE
  • ENV_RELEASE_NAME은 이전에 apigee-env 차트를 설치한 이름입니다.
  • ENV_NAME은 업그레이드하는 환경의 이름입니다.