Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menelan metrik Prometheus ke ruang kerja
<a name="AMP-onboard-ingest-metrics"></a>

Salah satu cara untuk menyerap metrik adalah dengan menggunakan agen Prometheus mandiri (instance Prometheus yang berjalan dalam mode *agen*) untuk mengikis metrik dari cluster Anda dan meneruskannya ke Layanan Terkelola Amazon untuk Prometheus untuk penyimpanan dan pemantauan. Bagian ini menjelaskan cara mengatur konsumsi metrik ke dalam Layanan Terkelola Amazon Anda untuk ruang kerja Prometheus dari Amazon EKS dengan menyiapkan instance baru agen Prometheus menggunakan Helm.

Untuk menghasilkan metrik di Amazon EKS, seperti Kubernetes atau metrik tingkat simpul, Anda dapat menggunakan add-on komunitas Amazon EKS. Untuk informasi selengkapnya, lihat [Add-on komunitas yang tersedia](https://docs.aws.amazon.com/eks/latest/userguide/community-addons.html#_available_community_add_ons) di *Panduan Pengguna Amazon EKS*.

Untuk informasi tentang cara lain untuk memasukkan data ke Layanan Terkelola Amazon untuk Prometheus, termasuk cara mengamankan metrik dan membuat metrik ketersediaan tinggi, lihat. [Menyerap metrik ke Layanan Terkelola Amazon Anda untuk ruang kerja Prometheus](AMP-ingest-methods.md)

**catatan**  
Metrik yang dimasukkan ke dalam ruang kerja disimpan selama 150 hari secara default, dan kemudian dihapus secara otomatis. Anda dapat menyesuaikan periode retensi dengan mengonfigurasi ruang kerja Anda hingga maksimum 1095 hari (tiga tahun). Untuk informasi selengkapnya, lihat [Mengonfigurasi ruang kerja Anda](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-workspace-configuration.html).

Petunjuk di bagian ini membuat Anda siap dan menjalankan Layanan Terkelola Amazon untuk Prometheus dengan cepat. Ini mengasumsikan bahwa Anda telah [membuat ruang kerja](AMP-onboard-create-workspace.md). Di bagian ini, Anda menyiapkan server Prometheus baru di kluster Amazon EKS, dan server baru menggunakan konfigurasi default untuk bertindak sebagai agen untuk mengirim metrik ke Amazon Managed Service untuk Prometheus. Metode ini memiliki prasyarat berikut:
+ Anda harus memiliki cluster Amazon EKS dari mana server Prometheus baru akan mengumpulkan metrik.
+ Cluster Amazon EKS Anda harus memiliki [driver Amazon EBS CSI](https://docs.aws.amazon.com/eks/latest/userguide/ebs-csi.html) yang diinstal (diperlukan oleh Helm).
+ Anda harus menggunakan Helm CLI 3.0 atau yang lebih baru.
+ Anda harus menggunakan komputer Linux atau macOS untuk melakukan langkah-langkah di bagian berikut.

## Langkah 1: Tambahkan repositori bagan Helm baru
<a name="AMP-quick-new-Prometheus-HelmRepo"></a>

Untuk menambahkan repositori bagan Helm baru, masukkan perintah berikut. Untuk informasi selengkapnya tentang perintah ini, lihat [Helm Repo](https://helm.sh/docs/helm/helm_repo/).

```
helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm repo add kube-state-metrics https://kubernetes.github.io/kube-state-metrics
helm repo update
```

## Langkah 2: Buat namespace Prometheus
<a name="AMP-quick-new-Prometheus-namespace"></a>

Masukkan perintah berikut untuk membuat namespace Prometheus untuk server Prometheus dan komponen pemantauan lainnya. Ganti {{prometheus-agent-namespace}} dengan nama yang Anda inginkan untuk namespace ini.

```
kubectl create namespace {{prometheus-agent-namespace}}
```

## Langkah 3: Siapkan peran IAM untuk akun layanan
<a name="AMP-quick-new-Prometheus-IRSA"></a>

Untuk metode konsumsi ini, Anda perlu menggunakan peran IAM untuk akun layanan di klaster Amazon EKS tempat agen Prometheus berjalan.

Dengan peran IAM untuk akun layanan, Anda dapat mengaitkan peran IAM dengan akun layanan Kubernetes. Akun layanan ini kemudian dapat memberikan AWS izin ke kontainer di pod mana pun yang menggunakan akun layanan tersebut. Untuk informasi selengkapnya, lihat [peran IAM untuk akun layanan](https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts.html).

Jika Anda belum mengatur peran ini, ikuti instruksi di [Menyiapkan peran layanan untuk menelan metrik dari kluster Amazon EKS](set-up-irsa.md#set-up-irsa-ingest) untuk mengatur peran. Instruksi di bagian itu memerlukan penggunaan`eksctl`. Untuk informasi selengkapnya, lihat [Memulai dengan Amazon Elastic Kubernetes Service](https://docs.aws.amazon.com/eks/latest/userguide/getting-started-eksctl.html) —. `eksctl` 

**catatan**  
Saat Anda tidak menggunakan EKS atau AWS dan hanya menggunakan kunci akses dan kunci rahasia untuk mengakses Layanan Terkelola Amazon untuk Prometheus, Anda tidak dapat menggunakan SigV4 berbasis. `EKS-IAM-ROLE`

## Langkah 4: Siapkan server baru dan mulai menelan metrik
<a name="AMP-quick-ingest-metrics-new-Prometheus-Helm"></a>

Untuk menginstal agen Prometheus baru dan mengirim metrik ke Layanan Terkelola Amazon untuk ruang kerja Prometheus, ikuti langkah-langkah berikut.

**Untuk menginstal agen Prometheus baru dan mengirim metrik ke Layanan Terkelola Amazon untuk ruang kerja Prometheus**

1. Gunakan editor teks untuk membuat file bernama `my_prometheus_values_yaml` dengan konten berikut.
   + Ganti {{IAM\_PROXY\_PROMETHEUS\_ROLE\_ARN}} dengan ARN dari **amp-iamproxy-ingest-role**yang Anda buat. [Menyiapkan peran layanan untuk menelan metrik dari kluster Amazon EKS](set-up-irsa.md#set-up-irsa-ingest)
   + Ganti {{WORKSPACE\_ID}} dengan ID Layanan Terkelola Amazon Anda untuk ruang kerja Prometheus.
   + Ganti {{REGION}} dengan Wilayah Layanan Terkelola Amazon Anda untuk ruang kerja Prometheus.

   ```
   ## The following is a set of default values for prometheus server helm chart which enable remoteWrite to AMP
   ## For the rest of prometheus helm chart values see: https://github.com/prometheus-community/helm-charts/blob/main/charts/prometheus/values.yaml
   ##
   serviceAccounts:
     server:
       name: amp-iamproxy-ingest-service-account
       annotations: 
         eks.amazonaws.com/role-arn: ${IAM_PROXY_PROMETHEUS_ROLE_ARN}
   server:
     remoteWrite:
       - url: https://aps-workspaces.${REGION}.amazonaws.com/workspaces/${WORKSPACE_ID}/api/v1/remote_write
         sigv4:
           region: ${REGION}
         queue_config:
           max_samples_per_send: 1000
           max_shards: 200
           capacity: 2500
   ```

1. Masukkan perintah berikut untuk membuat server Prometheus.
   + Ganti {{prometheus-chart-name}} dengan nama rilis Prometheus Anda.
   + Ganti {{prometheus-agent-namespace}} dengan nama namespace Prometheus Anda.

   ```
   helm install {{prometheus-chart-name}} prometheus-community/prometheus -n {{prometheus-agent-namespace}} \
   -f my_prometheus_values_yaml
   ```