Analisis dan pengumpulan data debug dengan residensi data

Ringkasan

Mulai versi 1.13.1, organisasi campuran Apigee yang baru dibuat dapat menggunakan pipeline data baru yang memungkinkan komponen runtime menulis data langsung ke platform kontrol. Sebelumnya, hal ini dilakukan melalui komponen UDCA yang menghasilkan URL yang ditandatangani untuk ditulis ke Layanan Google Cloud. Pipeline baru ini menghilangkan kebutuhan akan UDCA dan komponen terkait lainnya yang bertanggung jawab untuk memproses data yang diupload ke Layanan Google Cloud. Lihat Menggunakan retensi data dengan Apigee Hybrid.

Konfigurasi

Anda dapat mengonfigurasi hybrid untuk menggunakan pipeline data baru untuk setiap komponen menggunakan petunjuk berikut.

Alur Otorisasi Setelan

Tetapkan izin untuk akun layanan runtime agar dapat berinteraksi dengan pipeline baru untuk mengirim data ke platform kontrol. Langkah ini diperlukan agar sesi Debug dan Analytics dapat beroperasi dengan pipeline baru:

curl -X  PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type:application/json" \
  "https://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"]}'

Responsnya akan terlihat seperti berikut:

{
  "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"
  }
}

Verifikasi status operasi menggunakan parameter nama dari respons pembaruan: 

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

Responsnya akan terlihat seperti berikut:

{
  "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"
  }
}

Verifikasi konfigurasi ControlPlaneAccess organisasi:

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

Responsnya akan terlihat seperti berikut:

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

Beralih antara pipeline baru dan lama untuk debug dan retensi data Analytics

Setelah otorisasi yang tepat diberikan ke akun layanan, pengguna dapat mengalihkan instance Apigee mereka untuk menggunakan pipeline baru. Hal ini dapat dilakukan dengan menetapkan flag berikut di 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 ...

Terapkan perubahan ini dengan perintah helm upgrade. Mengupgrade satu lingkungan satu per satu. Tentukan lingkungan dengan --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 adalah nama yang Anda gunakan untuk menginstal diagram apigee-env sebelumnya.
  • ENV_NAME adalah nama lingkungan yang Anda upgrade.