Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menelan metrik dengan AWS kolektor terkelola
Kasus penggunaan umum untuk Amazon Managed Service untuk Prometheus adalah memantau klaster Kubernetes yang dikelola oleh Amazon Elastic Kubernetes Service (Amazon EKS). Cluster Kubernetes, dan banyak aplikasi yang berjalan di Amazon EKS, secara otomatis mengekspor metriknya untuk diakses oleh scraper yang kompatibel dengan Prometheus.
**catatan**
Amazon EKS mengekspos metrik, metrik, dan `kube-controller-manager` `kube-scheduler` metrik server API dalam sebuah cluster. Banyak teknologi dan aplikasi lain yang berjalan di lingkungan Kubernetes menyediakan metrik yang kompatibel dengan Prometheus. Untuk daftar eksportir yang terdokumentasi dengan baik, lihat [Eksportir dan integrasi dalam](https://prometheus.io/docs/instrumenting/exporters/) dokumentasi Prometheus.
Amazon Managed Service untuk Prometheus menyediakan scraper, *atau* kolektor yang dikelola sepenuhnya, tanpa agen, yang secara otomatis menemukan dan menarik metrik yang kompatibel dengan Prometheus. Anda tidak perlu mengelola, menginstal, menambal, atau memelihara agen atau pencakar. Layanan Terkelola Amazon untuk kolektor Prometheus menyediakan koleksi metrik yang andal, stabil, sangat tersedia, dan diskalakan secara otomatis untuk kluster Amazon EKS Anda. Layanan Terkelola Amazon untuk kolektor yang dikelola Prometheus bekerja dengan kluster Amazon EKS, termasuk EC2 dan Fargate.
Layanan Terkelola Amazon untuk kolektor Prometheus membuat Antarmuka Jaringan Elastis (ENI) per subnet yang ditentukan saat membuat scraper. Kolektor mengikis metrik melalui ini ENIs, dan menggunakannya `remote_write` untuk mendorong data ke Layanan Terkelola Amazon Anda untuk ruang kerja Prometheus menggunakan titik akhir VPC. Data yang tergores tidak pernah bepergian di internet publik.
Topik berikut memberikan informasi selengkapnya tentang cara menggunakan Layanan Terkelola Amazon untuk kolektor Prometheus di klaster Amazon EKS Anda, dan tentang metrik yang dikumpulkan.
**Topics**
+ [Siapkan kolektor terkelola untuk Amazon EKS](AMP-collector-how-to.md)
+ [Siapkan kolektor Prometheus yang dikelola untuk Amazon MSK](prom-msk-integration.md)
+ [Apa itu metrik yang kompatibel dengan Prometheus?](prom-compatible-metrics.md)
+ [Pantau kolektor dengan log penjual](AMP-collector-vended-logs.md)
# Siapkan kolektor terkelola untuk Amazon EKS
Untuk menggunakan Layanan Terkelola Amazon untuk kolektor Prometheus, Anda membuat scraper yang menemukan dan menarik metrik di klaster Amazon EKS Anda. Anda juga dapat membuat scraper yang terintegrasi dengan Amazon Managed Streaming for Apache Kafka. Untuk informasi selengkapnya, lihat [Mengintegrasikan MSK Amazon](https://docs.aws.amazon.com/prometheus/latest/userguide/prom-msk-integration.html).
+ Anda dapat membuat scraper sebagai bagian dari pembuatan cluster Amazon EKS Anda. Untuk informasi selengkapnya tentang membuat klaster Amazon EKS, termasuk membuat scraper, lihat [Membuat klaster Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html) di *Panduan Pengguna Amazon EKS*.
+ Anda dapat membuat scraper Anda sendiri, secara terprogram dengan AWS API atau dengan menggunakan. AWS CLI
Layanan Terkelola Amazon untuk kolektor Prometheus menggores metrik yang kompatibel dengan Prometheus. Untuk informasi selengkapnya tentang metrik yang kompatibel dengan Prometheus, lihat. [Apa itu metrik yang kompatibel dengan Prometheus?](prom-compatible-metrics.md) Cluster Amazon EKS mengekspos metrik untuk server API. Cluster Amazon EKS yang merupakan versi Kubernetes `1.28` atau lebih tinggi juga mengekspos metrik untuk dan. `kube-scheduler` `kube-controller-manager` *Untuk informasi selengkapnya, lihat [Mengambil metrik mentah bidang kontrol dalam format Prometheus di Panduan Pengguna Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/view-raw-metrics.html#scheduler-controller-metrics).*
**catatan**
Metrik pengikisan dari cluster dapat dikenakan biaya untuk penggunaan jaringan. Salah satu cara untuk mengoptimalkan biaya ini adalah dengan mengonfigurasi `/metrics` titik akhir Anda untuk mengompres metrik yang disediakan (misalnya, dengan gzip), mengurangi data yang harus dipindahkan di seluruh jaringan. Cara melakukannya tergantung pada aplikasi atau pustaka yang menyediakan metrik. Beberapa perpustakaan gzip secara default.
Topik berikut menjelaskan cara membuat, mengelola, dan mengonfigurasi pencakar.
**Topics**
+ [Buat scraper](#AMP-collector-create)
+ [Mengonfigurasi klaster Amazon EKS Anda](#AMP-collector-eks-setup)
+ [Temukan dan hapus pencakar](#AMP-collector-list-delete)
+ [Konfigurasi scraper](#AMP-collector-configuration)
+ [Memecahkan masalah konfigurasi scraper](#AMP-collector-troubleshoot)
+ [Keterbatasan scraper](#AMP-collector-limits)
## Buat scraper
Layanan Dikelola Amazon untuk kolektor Prometheus terdiri dari scraper yang menemukan dan mengumpulkan metrik dari cluster Amazon EKS. Amazon Managed Service for Prometheus mengelola scraper untuk Anda, memberi Anda skalabilitas, keamanan, dan keandalan yang Anda butuhkan, tanpa harus mengelola instans, agen, atau pencakar apa pun sendiri.
Ada tiga cara untuk membuat scraper:
+ Scraper dibuat secara otomatis untuk Anda saat Anda [membuat cluster Amazon EKS melalui konsol Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html) dan memilih untuk mengaktifkan metrik Prometheus.
+ Anda dapat membuat scraper dari konsol Amazon EKS untuk cluster yang ada. Buka cluster di [konsol Amazon EKS](https://console.aws.amazon.com/eks/home#/clusters), lalu, pada tab **Observability**, pilih **Add scraper**.
*Untuk detail selengkapnya tentang pengaturan yang tersedia, lihat [Mengaktifkan metrik Prometheus di Panduan Pengguna](https://docs.aws.amazon.com/eks/latest/userguide/prometheus.html#turn-on-prometheus-metrics) Amazon EKS.*
+ Anda dapat membuat scraper menggunakan AWS API atau file. AWS CLI
Opsi-opsi ini dijelaskan dalam prosedur berikut.
Ada beberapa prasyarat untuk membuat scraper Anda sendiri:
+ Anda harus memiliki kluster Amazon EKS yang dibuat.
+ Cluster Amazon EKS Anda harus memiliki [kontrol akses titik akhir cluster](https://docs.aws.amazon.com/eks/latest/userguide/cluster-endpoint.html) yang disetel untuk menyertakan akses pribadi. Ini dapat mencakup pribadi dan publik, tetapi harus mencakup pribadi.
+ [VPC Amazon tempat klaster Amazon EKS berada harus mengaktifkan DNS.](https://docs.aws.amazon.com/vpc/latest/userguide/AmazonDNS-concepts.html)
**catatan**
Cluster akan dikaitkan dengan scraper dengan nama sumber daya Amazon (ARN). Jika Anda menghapus cluster, dan kemudian membuat yang baru dengan nama yang sama, ARN akan digunakan kembali untuk cluster baru. Karena itu, scraper akan mencoba mengumpulkan metrik untuk cluster baru. Anda [menghapus pencakar](#AMP-collector-list-delete) secara terpisah dari menghapus cluster.
------
#### [ AWS API ]
**Untuk membuat scraper menggunakan API AWS **
Gunakan operasi `CreateScraper` API untuk membuat scraper dengan AWS API. Contoh berikut membuat scraper di `us-west-2` Wilayah. Anda perlu mengganti informasi cluster Akun AWS, ruang kerja, keamanan, dan Amazon EKS dengan milik Anda sendiri IDs, dan menyediakan konfigurasi yang akan digunakan untuk scraper Anda.
**catatan**
Grup keamanan dan subnet harus diatur ke grup keamanan dan subnet untuk cluster yang Anda hubungkan.
Anda harus menyertakan setidaknya dua subnet, setidaknya dalam dua zona ketersediaan.
`scrapeConfiguration`Ini adalah file YAMM konfigurasi Prometheus yang dikodekan base64. Anda dapat mengunduh konfigurasi tujuan umum dengan operasi `GetDefaultScraperConfiguration` API. Untuk informasi lebih lanjut tentang format`scrapeConfiguration`, lihat[Konfigurasi scraper](#AMP-collector-configuration).
```
POST /scrapers HTTP/1.1
Content-Length: 415
Authorization: AUTHPARAMS
X-Amz-Date: 20201201T193725Z
User-Agent: aws-cli/1.18.147 Python/2.7.18 Linux/5.4.58-37.125.amzn2int.x86_64 botocore/1.18.6
{
"alias": "myScraper",
"destination": {
"ampConfiguration": {
"workspaceArn": "arn:aws:aps:us-west-2:account-id:workspace/ws-workspace-id"
}
},
"source": {
"eksConfiguration": {
"clusterArn": "arn:aws:eks:us-west-2:account-id:cluster/cluster-name",
"securityGroupIds": ["sg-security-group-id"],
"subnetIds": ["subnet-subnet-id-1", "subnet-subnet-id-2"]
}
},
"scrapeConfiguration": {
"configurationBlob":
}
}
```
------
#### [ AWS CLI ]
**Untuk membuat scraper menggunakan AWS CLI**
Gunakan `create-scraper` perintah untuk membuat scraper dengan file. AWS CLI Contoh berikut membuat scraper di `us-west-2` Wilayah. Anda perlu mengganti informasi cluster Akun AWS, ruang kerja, keamanan, dan Amazon EKS dengan milik Anda sendiri IDs, dan menyediakan konfigurasi yang akan digunakan untuk scraper Anda.
**catatan**
Grup keamanan dan subnet harus diatur ke grup keamanan dan subnet untuk cluster yang Anda hubungkan.
Anda harus menyertakan setidaknya dua subnet, setidaknya dalam dua zona ketersediaan.
`scrape-configuration`Ini adalah file YAMM konfigurasi Prometheus yang dikodekan base64. Anda dapat mengunduh konfigurasi tujuan umum dengan `get-default-scraper-configuration` perintah. Untuk informasi lebih lanjut tentang format`scrape-configuration`, lihat[Konfigurasi scraper](#AMP-collector-configuration).
```
aws amp create-scraper \
--source eksConfiguration="{clusterArn='arn:aws:eks:us-west-2:account-id:cluster/cluster-name', securityGroupIds=['sg-security-group-id'],subnetIds=['subnet-subnet-id-1', 'subnet-subnet-id-2']}" \
--scrape-configuration configurationBlob= \
--destination ampConfiguration="{workspaceArn='arn:aws:aps:us-west-2:account-id:workspace/ws-workspace-id'}"
```
------
Berikut ini adalah daftar lengkap operasi scraper yang dapat Anda gunakan dengan AWS API:
+ Buat scraper dengan operasi [CreateScraper](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_CreateScraper.html)API.
+ Buat daftar scraper yang ada dengan operasi [ListScrapers](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_ListScrapers.html)API.
+ Perbarui alias, konfigurasi, atau tujuan scraper dengan operasi [UpdateScraper](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_UpdateScraper.html)API.
+ Hapus scraper dengan operasi [DeleteScraper](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_DeleteScraper.html)API.
+ Dapatkan detail selengkapnya tentang scraper dengan operasi [DescribeScraper](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_DescribeScraper.html)API.
+ Dapatkan konfigurasi tujuan umum untuk pencakar dengan operasi [GetDefaultScraperConfiguration](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_GetDefaultScraperConfiguration.html)API.
**catatan**
Cluster Amazon EKS yang Anda gores harus dikonfigurasi untuk memungkinkan Amazon Managed Service untuk Prometheus mengakses metrik. Topik berikutnya menjelaskan cara mengonfigurasi klaster Anda.
### Pengaturan lintas akun
Untuk membuat scraper lintas akun saat klaster Amazon EKS dan Layanan Terkelola Amazon untuk ruang kerja Prometheus berada di akun yang berbeda, gunakan prosedur berikut. Misalnya, Anda memiliki akun sumber yang `account_id_source` berisi kluster Amazon EKS dan akun target yang `account_id_target` berisi ruang kerja Amazon Managed Service for Prometheus.
**Untuk membuat scraper dalam pengaturan lintas akun**
1. Di akun sumber, buat peran `arn:aws:iam::account_id_source:role/Source` dan tambahkan kebijakan kepercayaan berikut.
```
{
"Effect": "Allow",
"Principal": {
"Service": [
"scraper.aps.amazonaws.com"
]
},
"Action": "sts:AssumeRole",
"Condition": {
"ArnEquals": {
"aws:SourceArn": "scraper_ARN"
},
"StringEquals": {
"AWS:SourceAccount": "account_id"
}
}
}
```
1. Di setiap kombinasi sumber (klaster Amazon EKS) dan target (Layanan Terkelola Amazon untuk ruang kerja Prometheus), Anda perlu membuat `arn:aws:iam::account_id_target:role/Target` peran dan menambahkan kebijakan kepercayaan berikut dengan izin untuk. [AmazonPrometheusRemoteWriteAccess](https://docs.aws.amazon.com/prometheus/latest/userguide/security-iam-awsmanpol.html)
```
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::account_id_source:role/Source"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"sts:ExternalId": "scraper_ARN"
}
}
}
```
1. Buat scraper dengan `--role-configuration` opsi.
```
aws amp create-scraper \
--source eksConfiguration="{clusterArn='arn:aws:eks:us-west-2:account-id_source:cluster/xarw,subnetIds=[subnet-subnet-id]}" \
--scrape-configuration configurationBlob= \
--destination ampConfiguration="{workspaceArn='arn:aws:aps:us-west-2:account-id_target:workspace/ws-workspace-id'}"\
--role-configuration '{"sourceRoleArn":"arn:aws:iam::account-id_source:role/Source", "targetRoleArn":"arn:aws:iam::account-id_target:role/Target"}'
```
1. Validasi pembuatan scraper.
```
aws amp list-scrapers
{
"scrapers": [
{
"scraperId": "scraper-id",
"arn": "arn:aws:aps:us-west-2:account_id_source:scraper/scraper-id",
"roleArn": "arn:aws:iam::account_id_source:role/aws-service-role/scraper.aps.amazonaws.com/AWSServiceRoleForAmazonPrometheusScraperInternal_cc319052-41a3-4",
"status": {
"statusCode": "ACTIVE"
},
"createdAt": "2024-10-29T16:37:58.789000+00:00",
"lastModifiedAt": "2024-10-29T16:55:17.085000+00:00",
"tags": {},
"source": {
"eksConfiguration": {
"clusterArn": "arn:aws:eks:us-west-2:account_id_source:cluster/xarw",
"securityGroupIds": [
"sg-security-group-id",
"sg-security-group-id"
],
"subnetIds": [
"subnet-subnet_id"
]
}
},
"destination": {
"ampConfiguration": {
"workspaceArn": "arn:aws:aps:us-west-2:account_id_target:workspace/ws-workspace-id"
}
}
}
]
}
```
### Mengubah antara RoleConfiguration dan peran terkait layanan
Jika Anda ingin beralih kembali ke peran terkait layanan alih-alih menulis `RoleConfiguration` ke Layanan Terkelola Amazon untuk ruang kerja Prometheus, Anda harus memperbarui `UpdateScraper` dan menyediakan ruang kerja di akun yang sama dengan scraper tanpa. `RoleConfiguration` `RoleConfiguration`Akan dihapus dari scraper dan peran terkait layanan akan digunakan.
Ketika Anda mengubah ruang kerja di akun yang sama dengan scraper dan Anda ingin terus menggunakan`RoleConfiguration`, Anda harus memberikan on lagi. `RoleConfiguration` `UpdateScraper`
### Membuat scraper untuk ruang kerja yang diaktifkan dengan kunci yang dikelola pelanggan
Untuk membuat scraper untuk memasukkan metrik ke dalam Layanan Terkelola Amazon untuk ruang kerja Prometheus dengan [kunci yang dikelola pelanggan](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk), gunakan dengan sumber dan target yang disetel ke akun yang `--role-configuration` sama.
```
aws amp create-scraper \
--source eksConfiguration="{clusterArn='arn:aws:eks:us-west-2:account-id:cluster/xarw,subnetIds=[subnet-subnet_id]}" \
--scrape-configuration configurationBlob= \
--destination ampConfiguration="{workspaceArn='arn:aws:aps:us-west-2:account-id:workspace/ws-workspace-id'}"\
--role-configuration '{"sourceRoleArn":"arn:aws:iam::account_id:role/Source", "targetRoleArn":"arn:aws:iam::account_id:role/Target"}'
```
### Kesalahan umum saat membuat pencakar
Berikut ini adalah masalah paling umum saat mencoba membuat scraper baru.
+ AWS Sumber daya yang dibutuhkan tidak ada. *Grup keamanan*, *subnet*, dan *klaster Amazon EKS* yang ditentukan harus ada.
+ Ruang alamat IP tidak mencukupi. Anda harus memiliki setidaknya satu alamat IP yang tersedia di setiap subnet yang Anda lewatkan ke `CreateScraper` API.
## Mengonfigurasi klaster Amazon EKS Anda
Cluster Amazon EKS Anda harus dikonfigurasi untuk memungkinkan scraper mengakses metrik. Ada dua opsi untuk konfigurasi ini:
+ Gunakan *entri akses* Amazon EKS untuk secara otomatis menyediakan Layanan Terkelola Amazon untuk akses kolektor Prometheus ke klaster Anda.
+ Konfigurasikan cluster Amazon EKS Anda secara manual untuk pengikisan metrik terkelola.
Topik berikut menjelaskan masing-masing secara lebih rinci.
### Konfigurasikan Amazon EKS untuk akses scraper dengan entri akses
Menggunakan entri akses untuk Amazon EKS adalah cara termudah untuk memberi Amazon Managed Service for Prometheus akses untuk mengikis metrik dari cluster Anda.
Cluster Amazon EKS yang Anda gores harus dikonfigurasi untuk memungkinkan otentikasi API. Mode otentikasi cluster harus diatur ke salah satu `API` atau`API_AND_CONFIG_MAP`. Ini dapat dilihat di konsol Amazon EKS pada tab **konfigurasi Access** pada detail cluster. Untuk informasi selengkapnya, lihat [Mengizinkan peran IAM atau pengguna mengakses objek Kubernetes di klaster Amazon EKS Anda di Panduan Pengguna *Amazon* EKS](https://docs.aws.amazon.com/eks/latest/userguide/access-entries.html).
Anda dapat membuat scraper saat membuat cluster, atau setelah membuat cluster:
+ **Saat membuat klaster** — Anda dapat mengonfigurasi akses ini saat [membuat klaster Amazon EKS melalui konsol Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html) (ikuti petunjuk untuk membuat scraper sebagai bagian dari cluster), dan kebijakan entri akses akan dibuat secara otomatis, memberikan Layanan Terkelola Amazon untuk Prometheus akses ke metrik klaster.
+ **Menambahkan setelah cluster dibuat** — jika kluster Amazon EKS Anda sudah ada, maka setel mode otentikasi ke salah satu `API` atau`API_AND_CONFIG_MAP`, dan pencakar apa pun yang Anda buat [melalui Layanan Terkelola Amazon untuk API Prometheus atau CLI atau melalui konsol Amazon EKS akan secara otomatis memiliki kebijakan entri](#AMP-collector-create) akses yang benar dibuat untuk Anda, dan pencakar akan memiliki akses ke cluster Anda.
**Kebijakan entri akses dibuat**
Saat Anda membuat scraper dan membiarkan Amazon Managed Service untuk Prometheus membuat kebijakan entri akses untuk Anda, itu akan menghasilkan kebijakan berikut. Untuk informasi selengkapnya tentang entri akses, lihat [Mengizinkan peran IAM atau pengguna mengakses Kubernetes](https://docs.aws.amazon.com/eks/latest/userguide/access-entries.html) di Panduan Pengguna *Amazon* EKS.
```
{
"rules": [
{
"effect": "allow",
"apiGroups": [
""
],
"resources": [
"nodes",
"nodes/proxy",
"nodes/metrics",
"services",
"endpoints",
"pods",
"ingresses",
"configmaps"
],
"verbs": [
"get",
"list",
"watch"
]
},
{
"effect": "allow",
"apiGroups": [
"extensions",
"networking.k8s.io"
],
"resources": [
"ingresses/status",
"ingresses"
],
"verbs": [
"get",
"list",
"watch"
]
},
{
"effect": "allow",
"apiGroups": [
"metrics.eks.amazonaws.com"
],
"resources": [
"kcm/metrics",
"ksh/metrics"
],
"verbs": [
"get"
]
},
{
"effect": "allow",
"nonResourceURLs": [
"/metrics"
],
"verbs": [
"get"
]
}
]
}
```
### Mengkonfigurasi Amazon EKS secara manual untuk akses scraper
Jika Anda lebih suka menggunakan akses kontrol `aws-auth ConfigMap` to ke cluster kubernetes Anda, Anda masih dapat memberikan Amazon Managed Service untuk Prometheus scraper akses ke metrik Anda. Langkah-langkah berikut akan memberi Amazon Managed Service for Prometheus akses untuk mengikis metrik dari klaster Amazon EKS Anda.
**catatan**
Untuk informasi selengkapnya tentang `ConfigMap` dan mengakses entri, lihat [Mengizinkan peran IAM atau pengguna mengakses Kubernetes](https://docs.aws.amazon.com/eks/latest/userguide/access-entries.html) di Panduan Pengguna *Amazon* EKS.
Prosedur ini menggunakan `kubectl` dan AWS CLI. Untuk informasi tentang menginstal`kubectl`, lihat [Menginstal kubectl di Panduan](https://docs.aws.amazon.com/eks/latest/userguide/install-kubectl.html) Pengguna *Amazon EKS*.
**Untuk mengonfigurasi klaster Amazon EKS secara manual untuk pengikisan metrik terkelola**
1. Buat file, bernama`clusterrole-binding.yml`, dengan teks berikut:
```
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
name: aps-collector-role
rules:
- apiGroups: [""]
resources: ["nodes", "nodes/proxy", "nodes/metrics", "services", "endpoints", "pods", "ingresses", "configmaps"]
verbs: ["describe", "get", "list", "watch"]
- apiGroups: ["extensions", "networking.k8s.io"]
resources: ["ingresses/status", "ingresses"]
verbs: ["describe", "get", "list", "watch"]
- nonResourceURLs: ["/metrics"]
verbs: ["get"]
- apiGroups: ["metrics.eks.amazonaws.com"]
resources: ["kcm/metrics", "ksh/metrics"]
verbs: ["get"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
name: aps-collector-user-role-binding
subjects:
- kind: User
name: aps-collector-user
apiGroup: rbac.authorization.k8s.io
roleRef:
kind: ClusterRole
name: aps-collector-role
apiGroup: rbac.authorization.k8s.io
```
1. Jalankan perintah berikut di cluster Anda:
```
kubectl apply -f clusterrole-binding.yml
```
Ini akan membuat pengikatan dan aturan peran cluster. Contoh ini digunakan `aps-collector-role` sebagai nama peran, dan `aps-collector-user` sebagai nama pengguna.
1. Perintah berikut memberi Anda informasi tentang scraper dengan ID*scraper-id*. Ini adalah scraper yang Anda buat menggunakan perintah di bagian sebelumnya.
```
aws amp describe-scraper --scraper-id scraper-id
```
1. Dari hasil`describe-scraper`, temukan `roleArn` .This akan memiliki format berikut:
```
arn:aws:iam::account-id:role/aws-service-role/scraper.aps.amazonaws.com/AWSServiceRoleForAmazonPrometheusScraper_unique-id
```
Amazon EKS membutuhkan format yang berbeda untuk ARN ini. Anda harus menyesuaikan format ARN yang dikembalikan untuk digunakan pada langkah berikutnya. Edit agar sesuai dengan format ini:
```
arn:aws:iam::account-id:role/AWSServiceRoleForAmazonPrometheusScraper_unique-id
```
Misalnya, ARN ini:
```
arn:aws:iam::111122223333:role/aws-service-role/scraper.aps.amazonaws.com/AWSServiceRoleForAmazonPrometheusScraper_1234abcd-56ef-7
```
Harus ditulis ulang sebagai:
```
arn:aws:iam::111122223333:role/AWSServiceRoleForAmazonPrometheusScraper_1234abcd-56ef-7
```
1. Jalankan perintah berikut di cluster Anda, menggunakan modifikasi `roleArn` dari langkah sebelumnya, serta nama cluster dan wilayah Anda. :
```
eksctl create iamidentitymapping --cluster cluster-name --region region-id --arn roleArn --username aps-collector-user
```
Ini memungkinkan scraper untuk mengakses cluster menggunakan peran dan pengguna yang Anda buat dalam `clusterrole-binding.yml` file.
## Temukan dan hapus pencakar
Anda dapat menggunakan AWS API atau AWS CLI untuk membuat daftar pencakar di akun Anda atau untuk menghapusnya.
**catatan**
Pastikan Anda menggunakan versi terbaru AWS CLI atau SDK. Versi terbaru memberi Anda fitur dan fungsionalitas terbaru, serta pembaruan keamanan. Atau, gunakan [AWS CloudShell](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html), yang selalu memberikan pengalaman baris up-to-date perintah, secara otomatis.
Untuk mencantumkan semua pencakar di akun Anda, gunakan operasi [ListScrapers](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_ListScrapers.html)API.
Atau, dengan AWS CLI, hubungi:
```
aws amp list-scrapers --region aws-region
```
`ListScrapers`mengembalikan semua pencakar di akun Anda, misalnya:
```
{
"scrapers": [
{
"scraperId": "s-1234abcd-56ef-7890-abcd-1234ef567890",
"arn": "arn:aws:aps:us-west-2:123456789012:scraper/s-1234abcd-56ef-7890-abcd-1234ef567890",
"roleArn": "arn:aws:iam::123456789012:role/aws-service-role/AWSServiceRoleForAmazonPrometheusScraper_1234abcd-2931",
"status": {
"statusCode": "DELETING"
},
"createdAt": "2023-10-12T15:22:19.014000-07:00",
"lastModifiedAt": "2023-10-12T15:55:43.487000-07:00",
"tags": {},
"source": {
"eksConfiguration": {
"clusterArn": "arn:aws:eks:us-west-2:123456789012:cluster/my-cluster",
"securityGroupIds": [
"sg-1234abcd5678ef90"
],
"subnetIds": [
"subnet-abcd1234ef567890",
"subnet-1234abcd5678ab90"
]
}
},
"destination": {
"ampConfiguration": {
"workspaceArn": "arn:aws:aps:us-west-2:123456789012:workspace/ws-1234abcd-5678-ef90-ab12-cdef3456a78"
}
}
}
]
}
```
Untuk menghapus scraper, cari scraper yang ingin Anda hapus, menggunakan `ListScrapers` operasi, dan kemudian gunakan [DeleteScraper](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_DeleteScraper.html)operasi untuk menghapusnya. `scraperId`
Atau, dengan AWS CLI, hubungi:
```
aws amp delete-scraper --scraper-id scraperId
```
## Konfigurasi scraper
Anda dapat mengontrol bagaimana scraper Anda menemukan dan mengumpulkan metrik dengan konfigurasi scraper yang kompatibel dengan Prometheus. Misalnya, Anda dapat mengubah interval metrik yang dikirim ke ruang kerja. Anda juga dapat menggunakan pelabelan ulang untuk menulis ulang label metrik secara dinamis. Konfigurasi scraper adalah file YAMG yang merupakan bagian dari definisi scraper.
Saat scraper baru dibuat, Anda menentukan konfigurasi dengan menyediakan file YAMM yang dikodekan base64 dalam panggilan API. Anda dapat mengunduh file konfigurasi tujuan umum dengan `GetDefaultScraperConfiguration` operasi di Amazon Managed Service for Prometheus API.
Untuk memodifikasi konfigurasi scraper, Anda dapat menggunakan `UpdateScraper` operasi. Jika Anda perlu memperbarui sumber metrik (misalnya, ke cluster Amazon EKS yang berbeda), Anda harus menghapus scraper dan membuatnya kembali dengan sumber baru.
**Konfigurasi yang didukung**
Untuk informasi tentang format konfigurasi scraper, termasuk rincian rinci dari nilai yang mungkin, lihat [Konfigurasi](https://prometheus.io/docs/prometheus/latest/configuration/configuration/) dalam dokumentasi Prometheus. Opsi konfigurasi global, dan `` opsi menjelaskan opsi yang paling umum dibutuhkan.
Karena Amazon EKS adalah satu-satunya layanan yang didukung, satu-satunya service discovery config (`<*_sd_config>`) yang didukung adalah. ``
Daftar lengkap bagian konfigurasi diperbolehkan:
+ ``
+ ``
+ ``
+ ``
+ ``
+ ``
Keterbatasan dalam bagian ini tercantum setelah file konfigurasi sampel.
**Contoh file konfigurasi**
Berikut ini adalah contoh file konfigurasi YAMAL dengan interval scrape 30 detik. Contoh ini mencakup dukungan untuk metrik server API kube, serta metrik kube-controller-manager dan kube-scheduler. *Untuk informasi selengkapnya, lihat [Mengambil metrik mentah bidang kontrol dalam format Prometheus di Panduan Pengguna Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/view-raw-metrics.html#scheduler-controller-metrics).*
```
global:
scrape_interval: 30s
external_labels:
clusterArn: apiserver-test-2
scrape_configs:
- job_name: pod_exporter
kubernetes_sd_configs:
- role: pod
- job_name: cadvisor
scheme: https
authorization:
type: Bearer
credentials_file: /var/run/secrets/kubernetes.io/serviceaccount/token
kubernetes_sd_configs:
- role: node
relabel_configs:
- action: labelmap
regex: __meta_kubernetes_node_label_(.+)
- replacement: kubernetes.default.svc:443
target_label: __address__
- source_labels: [__meta_kubernetes_node_name]
regex: (.+)
target_label: __metrics_path__
replacement: /api/v1/nodes/$1/proxy/metrics/cadvisor
# apiserver metrics
- scheme: https
authorization:
type: Bearer
credentials_file: /var/run/secrets/kubernetes.io/serviceaccount/token
job_name: kubernetes-apiservers
kubernetes_sd_configs:
- role: endpoints
relabel_configs:
- action: keep
regex: default;kubernetes;https
source_labels:
- __meta_kubernetes_namespace
- __meta_kubernetes_service_name
- __meta_kubernetes_endpoint_port_name
# kube proxy metrics
- job_name: kube-proxy
honor_labels: true
kubernetes_sd_configs:
- role: pod
relabel_configs:
- action: keep
source_labels:
- __meta_kubernetes_namespace
- __meta_kubernetes_pod_name
separator: '/'
regex: 'kube-system/kube-proxy.+'
- source_labels:
- __address__
action: replace
target_label: __address__
regex: (.+?)(\\:\\d+)?
replacement: $1:10249
# Scheduler metrics
- job_name: 'ksh-metrics'
kubernetes_sd_configs:
- role: endpoints
metrics_path: /apis/metrics.eks.amazonaws.com/v1/ksh/container/metrics
scheme: https
bearer_token_file: /var/run/secrets/kubernetes.io/serviceaccount/token
relabel_configs:
- source_labels:
- __meta_kubernetes_namespace
- __meta_kubernetes_service_name
- __meta_kubernetes_endpoint_port_name
action: keep
regex: default;kubernetes;https
# Controller Manager metrics
- job_name: 'kcm-metrics'
kubernetes_sd_configs:
- role: endpoints
metrics_path: /apis/metrics.eks.amazonaws.com/v1/kcm/container/metrics
scheme: https
bearer_token_file: /var/run/secrets/kubernetes.io/serviceaccount/token
relabel_configs:
- source_labels:
- __meta_kubernetes_namespace
- __meta_kubernetes_service_name
- __meta_kubernetes_endpoint_port_name
action: keep
regex: default;kubernetes;https
```
Berikut ini adalah batasan khusus untuk kolektor yang AWS dikelola:
+ **Interval mengikis** - Konfigurasi scraper tidak dapat menentukan interval gesekan kurang dari 30 detik.
+ **Target** — Target dalam `static_config` harus ditentukan sebagai alamat IP.
+ **Resolusi DNS** — Terkait dengan nama target, satu-satunya nama server yang dikenali dalam konfigurasi ini adalah server api Kubernetes,. `kubernetes.default.svc` Semua nama mesin lainnya harus ditentukan oleh alamat IP.
+ **Otorisasi** - Hilangkan jika tidak ada otorisasi yang diperlukan. Jika diperlukan, otorisasi harus`Bearer`, dan harus menunjuk ke file`/var/run/secrets/kubernetes.io/serviceaccount/token`. Dengan kata lain, jika digunakan, bagian otorisasi harus terlihat seperti berikut:
```
authorization:
type: Bearer
credentials_file: /var/run/secrets/kubernetes.io/serviceaccount/token
```
**catatan**
`type: Bearer`adalah default, sehingga dapat dihilangkan.
## Memecahkan masalah konfigurasi scraper
Layanan Terkelola Amazon untuk kolektor Prometheus secara otomatis menemukan dan mengikis metrik. Tetapi bagaimana Anda bisa memecahkan masalah saat Anda tidak melihat metrik yang Anda harapkan di Layanan Terkelola Amazon untuk ruang kerja Prometheus?
**penting**
Verifikasi bahwa akses pribadi untuk kluster Amazon EKS Anda diaktifkan. Untuk informasi selengkapnya, lihat [Titik akhir pribadi cluster](https://docs.aws.amazon.com/eks/latest/userguide/cluster-endpoint.html#cluster-endpoint-private) di *Panduan Pengguna Amazon EKS*.
`up`Metrik adalah alat yang bermanfaat. Untuk setiap titik akhir yang ditemukan oleh Amazon Managed Service untuk kolektor Prometheus, secara otomatis menjual metrik ini. Ada tiga status metrik ini yang dapat membantu Anda memecahkan masalah apa yang terjadi di dalam kolektor.
+ `up`tidak ada — Jika tidak ada `up` metrik untuk titik akhir, maka itu berarti kolektor tidak dapat menemukan titik akhir.
Jika Anda yakin bahwa titik akhir ada, ada beberapa alasan mengapa kolektor mungkin tidak dapat menemukannya.
+ Anda mungkin perlu menyesuaikan konfigurasi scrape. Penemuan ini `relabel_config` mungkin perlu disesuaikan.
+ Mungkin ada masalah dengan yang `role` digunakan untuk penemuan.
+ VPC Amazon yang digunakan oleh cluster Amazon EKS mungkin tidak [mengaktifkan DNS](https://docs.aws.amazon.com/vpc/latest/userguide/AmazonDNS-concepts.html), yang akan mencegah kolektor menemukan titik akhir.
+ `up`ada, tetapi selalu 0 — Jika `up` ada, tetapi 0, maka kolektor dapat menemukan titik akhir, tetapi tidak dapat menemukan metrik yang kompatibel dengan Prometheus.
Dalam hal ini, Anda dapat mencoba menggunakan `curl` perintah terhadap titik akhir secara langsung. Anda dapat memvalidasi bahwa Anda memiliki detail yang benar, misalnya, protokol (`http`atau`https`), titik akhir, atau port yang Anda gunakan. Anda juga dapat memeriksa apakah titik akhir merespons dengan respons yang valid, dan mengikuti `200` format Prometheus. Akhirnya, tubuh respons tidak bisa lebih besar dari ukuran maksimum yang diizinkan. (Untuk batasan kolektor AWS terkelola, lihat bagian berikut.)
+ `up`hadir dan lebih besar dari 0 — Jika `up` ada, dan lebih besar dari 0, maka metrik sedang dikirim ke Amazon Managed Service untuk Prometheus.
Validasi bahwa Anda mencari metrik yang benar di Amazon Managed Service untuk Prometheus (atau dasbor alternatif Anda, seperti Grafana yang Dikelola Amazon). Anda dapat menggunakan curl lagi untuk memeriksa data yang diharapkan di titik `/metrics` akhir Anda. Periksa juga apakah Anda belum melampaui batas lain, seperti jumlah titik akhir per scraper. Anda dapat memeriksa jumlah titik akhir metrik yang dikikis dengan memeriksa jumlah metrik, menggunakan. `up` `count(up)`
## Keterbatasan scraper
Ada beberapa batasan untuk pencakar yang dikelola sepenuhnya yang disediakan oleh Amazon Managed Service untuk Prometheus.
+ **Wilayah** — Cluster EKS Anda, scraper terkelola, dan Layanan Terkelola Amazon untuk ruang kerja Prometheus semuanya harus berada di Wilayah yang sama. AWS
+ **Kolektor** - Anda dapat memiliki maksimal 10 Layanan Dikelola Amazon untuk pencakar Prometheus per wilayah per akun.
**catatan**
Anda dapat meminta kenaikan batas ini dengan [meminta kenaikan kuota](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase).
+ **Respons metrik** - Isi respons dari salah satu permintaan `/metrics` titik akhir tidak boleh lebih dari 50 megabyte (MB).
+ **Titik akhir per scraper** - Scraper dapat mengikis maksimum 30.000 titik akhir. `/metrics`
+ **Interval mengikis** - Konfigurasi scraper tidak dapat menentukan interval gesekan kurang dari 30 detik.
# Siapkan kolektor Prometheus yang dikelola untuk Amazon MSK
Untuk menggunakan Layanan Terkelola Amazon untuk kolektor Prometheus, Anda membuat scraper yang menemukan dan menarik metrik di cluster Amazon Managed Streaming for Apache Kafka. Anda juga dapat membuat scraper yang terintegrasi dengan Amazon Elastic Kubernetes Service. Untuk informasi selengkapnya, lihat [Mengintegrasikan Amazon EKS](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-collector-how-to.html).
## Buat scraper
Layanan Dikelola Amazon untuk kolektor Prometheus terdiri dari scraper yang menemukan dan mengumpulkan metrik dari cluster MSK Amazon. Amazon Managed Service for Prometheus mengelola scraper untuk Anda, memberi Anda skalabilitas, keamanan, dan keandalan yang Anda butuhkan, tanpa harus mengelola instans, agen, atau pencakar apa pun sendiri.
Anda dapat membuat scraper menggunakan AWS API atau AWS CLI seperti yang dijelaskan dalam prosedur berikut.
Ada beberapa prasyarat untuk membuat scraper Anda sendiri:
+ Anda harus memiliki kluster MSK Amazon yang dibuat.
+ Konfigurasikan grup keamanan klaster MSK Amazon Anda untuk mengizinkan lalu lintas masuk pada port **11001 (Eksportir JMX) dan 11002 (Node Exporter)** **dalam VPC Amazon Anda, karena scraper memerlukan akses** ke catatan DNS ini untuk mengumpulkan metrik Prometheus.
+ [VPC Amazon tempat klaster MSK Amazon berada harus mengaktifkan DNS.](https://docs.aws.amazon.com/vpc/latest/userguide/AmazonDNS-concepts.html)
**catatan**
Cluster akan dikaitkan dengan scraper dengan nama sumber daya Amazon (ARN). Jika Anda menghapus cluster, dan kemudian membuat yang baru dengan nama yang sama, ARN akan digunakan kembali untuk cluster baru. Karena itu, scraper akan mencoba mengumpulkan metrik untuk cluster baru. Anda [menghapus pencakar](#prom-msk-delete-scraper) secara terpisah dari menghapus cluster.
------
#### [ To create a scraper using the AWS API ]
Gunakan operasi `CreateScraper` API untuk membuat scraper dengan AWS API. Contoh berikut membuat scraper di Wilayah AS Timur (Virginia N.). Ganti *example* konten dengan informasi cluster MSK Amazon Anda, dan berikan konfigurasi scraper Anda.
**catatan**
Konfigurasikan grup keamanan dan subnet agar sesuai dengan kluster target Anda. Sertakan setidaknya dua subnet di dua zona ketersediaan.
```
POST /scrapers HTTP/1.1
Content-Length: 415
Authorization: AUTHPARAMS
X-Amz-Date: 20201201T193725Z
User-Agent: aws-cli/1.18.147 Python/2.7.18 Linux/5.4.58-37.125.amzn2int.x86_64 botocore/1.18.6
{
"alias": "myScraper",
"destination": {
"ampConfiguration": {
"workspaceArn": "arn:aws:aps:us-east-1:123456789012:workspace/ws-workspace-id"
}
},
"source": {
"vpcConfiguration": {
"securityGroupIds": ["sg-security-group-id"],
"subnetIds": ["subnet-subnet-id-1", "subnet-subnet-id-2"]
}
},
"scrapeConfiguration": {
"configurationBlob": base64-encoded-blob
}
}
```
Dalam contoh, `scrapeConfiguration` parameter memerlukan file YAMM konfigurasi Prometheus yang dikodekan base64 yang menentukan catatan DNS dari kluster MSK.
Setiap catatan DNS mewakili titik akhir broker di Availability Zone tertentu, memungkinkan klien untuk terhubung ke broker yang didistribusikan di seluruh pilihan Anda AZs untuk ketersediaan tinggi.
Jumlah catatan DNS di properti klaster MSK Anda sesuai dengan jumlah node broker dan Availability Zone dalam konfigurasi klaster Anda:
+ **Konfigurasi default** - 3 node broker di 3 AZs = 3 catatan DNS
+ **Konfigurasi khusus** - 2 node broker di 2 AZs = 2 catatan DNS
[Untuk mendapatkan catatan DNS untuk cluster MSK Anda, buka konsol MSK di rumah? https://console.aws.amazon.com/msk/ region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/). Pergi ke cluster MSK Anda. Pilih **Properti**, **Broker**, dan **Titik Akhir**.
Anda memiliki dua opsi untuk mengonfigurasi Prometheus untuk mengikis metrik dari cluster MSK Anda:
1. **Resolusi DNS tingkat cluster (Disarankan)** — Gunakan nama DNS dasar cluster untuk secara otomatis menemukan semua broker. Jika titik akhir broker Anda`b-1.clusterName.xxx.xxx.xxx`, gunakan `clusterName.xxx.xxx.xxx` sebagai catatan DNS. Hal ini memungkinkan Prometheus untuk secara otomatis mengikis semua broker di cluster.
**Titik akhir broker individu** — Tentukan setiap titik akhir broker secara individual untuk kontrol granular. Gunakan pengidentifikasi broker lengkap (b-1, b-2) dalam konfigurasi Anda. Contoh:
```
dns_sd_configs:
- names:
- b-1.clusterName.xxx.xxx.xxx
- b-2.clusterName.xxx.xxx.xxx
- b-3.clusterName.xxx.xxx.xxx
```
**catatan**
Ganti `clusterName.xxx.xxx.xxx` dengan titik akhir klaster MSK Anda yang sebenarnya dari Konsol. AWS
Untuk informasi lebih lanjut, lihat[https://prometheus.io/docs/prometheus/latest/configuration/configuration/#dns_sd_config](https://prometheus.io/docs/prometheus/latest/configuration/configuration/#dns_sd_config) di dokumentasi *Prometheus*.
Berikut ini adalah contoh file konfigurasi scraper:
```
global:
scrape_interval: 30s
external_labels:
clusterArn: msk-test-1
scrape_configs:
- job_name: msk-jmx
scheme: http
metrics_path: /metrics
scrape_timeout: 10s
dns_sd_configs:
- names:
- dns-record-1
- dns-record-2
- dns-record-3
type: A
port: 11001
relabel_configs:
- source_labels: [__meta_dns_name]
target_label: broker_dns
- source_labels: [__address__]
target_label: instance
regex: '(.*)'
replacement: '${1}'
- job_name: msk-node
scheme: http
metrics_path: /metrics
scrape_timeout: 10s
dns_sd_configs:
- names:
- dns-record-1
- dns-record-2
- dns-record-3
type: A
port: 11002
relabel_configs:
- source_labels: [__meta_dns_name]
target_label: broker_dns
- source_labels: [__address__]
target_label: instance
regex: '(.*)'
replacement: '${1}'
```
Jalankan salah satu perintah berikut untuk mengonversi file YAMM ke base64. Anda juga dapat menggunakan konverter base64 online apa pun untuk mengonversi file.
**Example Linux/macOS**
```
echo -n scraper config updated with dns records | base64
```
**Example Jendela PowerShell**
```
[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes(scraper config updated with dns records))
```
------
#### [ To create a scraper using the AWS CLI ]
Gunakan `create-scraper` perintah untuk membuat scraper menggunakan file. AWS Command Line Interface Contoh berikut membuat scraper di Wilayah AS Timur (Virginia N.). Ganti *example* konten dengan informasi cluster MSK Amazon Anda, dan berikan konfigurasi scraper Anda.
**catatan**
Konfigurasikan grup keamanan dan subnet agar sesuai dengan kluster target Anda. Sertakan setidaknya dua subnet di dua zona ketersediaan.
```
aws amp create-scraper \
--source vpcConfiguration="{securityGroupIds=['sg-security-group-id'],subnetIds=['subnet-subnet-id-1', 'subnet-subnet-id-2']}" \
--scrape-configuration configurationBlob=base64-encoded-blob \
--destination ampConfiguration="{workspaceArn='arn:aws:aps:us-west-2:123456789012:workspace/ws-workspace-id'}"
```
------
+ Berikut ini adalah daftar lengkap operasi scraper yang dapat Anda gunakan dengan AWS API:
Buat scraper dengan operasi [CreateScraper](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_CreateScraper.html)API.
+ Buat daftar scraper yang ada dengan operasi [ListScrapers](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_ListScrapers.html)API.
+ Perbarui alias, konfigurasi, atau tujuan scraper dengan operasi [UpdateScraper](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_UpdateScraper.html)API.
+ Hapus scraper dengan operasi [DeleteScraper](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_DeleteScraper.html)API.
+ Dapatkan detail selengkapnya tentang scraper dengan operasi [DescribeScraper](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_DescribeScraper.html)API.
## Pengaturan lintas akun
Untuk membuat scraper dalam penyiapan lintas akun saat klaster MSK Amazon tempat Anda ingin mengumpulkan metrik berada di akun yang berbeda dari kolektor Layanan Terkelola Amazon untuk Prometheus, gunakan prosedur di bawah ini.
Misalnya, ketika Anda memiliki dua akun, akun sumber pertama `account_id_source` tempat MSK Amazon berada, dan akun target kedua `account_id_target` tempat Amazon Managed Service untuk ruang kerja Prometheus berada.
**Untuk membuat scraper dalam pengaturan lintas akun**
1. Di akun sumber, buat peran `arn:aws:iam::111122223333:role/Source` dan tambahkan kebijakan kepercayaan berikut.
```
{
"Effect": "Allow",
"Principal": {
"Service": [
"scraper.aps.amazonaws.com"
]
},
"Action": "sts:AssumeRole",
"Condition": {
"ArnEquals": {
"aws:SourceArn": "arn:aws:aps:aws-region:111122223333:scraper/scraper-id"
},
"StringEquals": {
"AWS:SourceAccount": "111122223333"
}
}
}
```
1. Di setiap kombinasi sumber (klaster MSK Amazon) dan target (Layanan Terkelola Amazon untuk ruang kerja Prometheus), Anda perlu membuat `arn:aws:iam::444455556666:role/Target` peran dan menambahkan kebijakan kepercayaan berikut dengan izin untuk. [AmazonPrometheusRemoteWriteAccess](https://docs.aws.amazon.com/prometheus/latest/userguide/security-iam-awsmanpol.html)
```
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::111122223333:role/Source"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"sts:ExternalId": "arn:aws:aps:aws-region:111122223333:scraper/scraper-id"
}
}
}
```
1. Buat scraper dengan `--role-configuration` opsi.
```
aws amp create-scraper \ --source vpcConfiguration="{subnetIds=[subnet-subnet-id], "securityGroupIds": ["sg-security-group-id"]}" \ --scrape-configuration configurationBlob= \ --destination ampConfiguration="{workspaceArn='arn:aws:aps:aws-region:444455556666:workspace/ws-workspace-id'}"\ --role-configuration '{"sourceRoleArn":"arn:aws:iam::111122223333:role/Source", "targetRoleArn":"arn:aws:iam::444455556666:role/Target"}'
```
1. Validasi pembuatan scraper.
```
aws amp list-scrapers
{
"scrapers": [
{
"scraperId": "s-example123456789abcdef0",
"arn": "arn:aws:aps:aws-region:111122223333:scraper/s-example123456789abcdef0": "arn:aws:iam::111122223333:role/Source",
"status": "ACTIVE",
"creationTime": "2025-10-27T18:45:00.000Z",
"lastModificationTime": "2025-10-27T18:50:00.000Z",
"tags": {},
"statusReason": "Scraper is running successfully",
"source": {
"vpcConfiguration": {
"subnetIds": ["subnet-subnet-id"],
"securityGroupIds": ["sg-security-group-id"]
}
},
"destination": {
"ampConfiguration": {
"workspaceArn": "arn:aws:aps:aws-region:444455556666:workspace/ws-workspace-id'"
}
},
"scrapeConfiguration": {
"configurationBlob": ""
}
}
]
}
```
## Mengubah antara RoleConfiguration dan peran terkait layanan
Jika Anda ingin beralih kembali ke peran terkait layanan alih-alih menulis `RoleConfiguration` ke Layanan Terkelola Amazon untuk ruang kerja Prometheus, Anda harus memperbarui `UpdateScraper` dan menyediakan ruang kerja di akun yang sama dengan scraper tanpa. `RoleConfiguration` `RoleConfiguration`Akan dihapus dari scraper dan peran terkait layanan akan digunakan.
Ketika Anda mengubah ruang kerja di akun yang sama dengan scraper dan Anda ingin terus menggunakan`RoleConfiguration`, Anda harus memberikan on lagi. `RoleConfiguration` `UpdateScraper`
## Temukan dan hapus pencakar
Anda dapat menggunakan AWS API atau AWS CLI untuk membuat daftar pencakar di akun Anda atau untuk menghapusnya.
**catatan**
Pastikan Anda menggunakan versi terbaru AWS CLI atau SDK. Versi terbaru memberi Anda fitur dan fungsionalitas terbaru, serta pembaruan keamanan. Atau, gunakan [AWS CloudShell](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html), yang selalu memberikan pengalaman baris up-to-date perintah, secara otomatis.
Untuk mencantumkan semua pencakar di akun Anda, gunakan operasi [ListScrapers](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_ListScrapers.html)API.
Atau, dengan AWS CLI, hubungi:
```
aws amp list-scrapers
```
`ListScrapers`mengembalikan semua pencakar di akun Anda, misalnya:
```
{
"scrapers": [
{
"scraperId": "s-1234abcd-56ef-7890-abcd-1234ef567890",
"arn": "arn:aws:aps:aws-region:123456789012:scraper/s-1234abcd-56ef-7890-abcd-1234ef567890",
"roleArn": "arn:aws:iam::123456789012:role/aws-service-role/AWSServiceRoleForAmazonPrometheusScraper_1234abcd-2931",
"status": {
"statusCode": "DELETING"
},
"createdAt": "2023-10-12T15:22:19.014000-07:00",
"lastModifiedAt": "2023-10-12T15:55:43.487000-07:00",
"tags": {},
"source": {
"vpcConfiguration": {
"securityGroupIds": [
"sg-1234abcd5678ef90"
],
"subnetIds": [
"subnet-abcd1234ef567890",
"subnet-1234abcd5678ab90"
]
}
},
"destination": {
"ampConfiguration": {
"workspaceArn": "arn:aws:aps:aws-region:123456789012:workspace/ws-1234abcd-5678-ef90-ab12-cdef3456a78"
}
}
}
]
}
```
Untuk menghapus scraper, cari scraper yang ingin Anda hapus, menggunakan `ListScrapers` operasi, dan kemudian gunakan [DeleteScraper](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_DeleteScraper.html)operasi untuk menghapusnya. `scraperId`
Atau, dengan AWS CLI, hubungi:
```
aws amp delete-scraper --scraper-id scraperId
```
## Metrik dikumpulkan dari Amazon MSK
Saat Anda berintegrasi dengan Amazon MSK, kolektor Layanan Terkelola Amazon untuk Prometheus secara otomatis mengikis metrik berikut:
### Metrik: pekerjaan jmx\$1exporter dan pod\$1exporter
| Metrik | Deskripsi/Tujuan |
| --- | --- |
| jmx\$1config\$1reload\$1failure\$1total | Jumlah total eksportir JMX gagal memuat ulang file konfigurasinya. |
| jmx\$1scrape\$1duration\$1seconds | Waktu yang dibutuhkan untuk mengikis metrik JMX dalam hitungan detik untuk siklus pengumpulan saat ini. |
| jmx\$1scrape\$1error | Menunjukkan apakah terjadi kesalahan selama pengikisan metrik JMX (1 = kesalahan, 0 = sukses). |
| java\$1lang\$1memory\$1 \$1digunakan HeapMemoryUsage | Jumlah memori heap (dalam byte) yang saat ini digunakan oleh JVM. |
| Java\$1lang\$1memory\$1 \$1max HeapMemoryUsage | Jumlah maksimum memori heap (dalam byte) yang dapat digunakan untuk manajemen memori. |
| java\$1lang\$1memory\$1 \$1digunakan NonHeapMemoryUsage | Jumlah memori non-heap (dalam byte) yang saat ini digunakan oleh JVM. |
| Kafka\$1cluster\$1partition\$1value | Status atau nilai saat ini terkait dengan partisi cluster Kafka, dipecah berdasarkan ID partisi dan topik. |
| kafka\$1consumer\$1consumer\$1coordinator\$1metrics\$1assigned\$1partitions | Jumlah partisi yang saat ini ditugaskan untuk konsumen ini. |
| kafka\$1consumer\$1consumer\$1coordinator\$1metrics\$1commit\$1latency\$1avg | Rata-rata waktu yang dibutuhkan untuk melakukan offset dalam milidetik. |
| kafka\$1consumer\$1consumer\$1coordinator\$1metrics\$1commit\$1rate | Jumlah komit offset per detik. |
| kafka\$1consumer\$1consumer\$1coordinator\$1metrics\$1failed\$1rebalance\$1total | Jumlah total rebalances kelompok konsumen yang gagal. |
| kafka\$1consumer\$1consumer\$1coordinator\$1metrics\$1last\$1heartbeat\$1seconds\$1ago | Jumlah detik sejak detak jantung terakhir dikirim ke koordinator. |
| kafka\$1consumer\$1consumer\$1coordinator\$1metrics\$1rebalance\$1latency\$1avg | Rata-rata waktu yang dibutuhkan untuk menyeimbangkan kembali kelompok konsumen dalam milidetik. |
| kafka\$1consumer\$1consumer\$1coordinator\$1metrics\$1rebalance\$1total | Jumlah total penyeimbangan kembali kelompok konsumen. |
| kafka\$1consumer\$1consumer\$1fetch\$1manager\$1metrics\$1bytes\$1consumed\$1rate | Jumlah rata-rata byte yang dikonsumsi per detik oleh konsumen. |
| kafka\$1consumer\$1consumer\$1fetch\$1manager\$1metrics\$1fetch\$1latency\$1avg | Rata-rata waktu yang dibutuhkan untuk permintaan pengambilan dalam milidetik. |
| kafka\$1consumer\$1consumer\$1fetch\$1manager\$1metrics\$1fetch\$1rate | Jumlah permintaan pengambilan per detik. |
| kafka\$1consumer\$1consumer\$1fetch\$1manager\$1metrics\$1records\$1consumed\$1rate | Rata-rata jumlah catatan yang dikonsumsi per detik. |
| kafka\$1consumer\$1consumer\$1fetch\$1manager\$1metrics\$1records\$1lag\$1max | Kelambatan maksimum dalam hal jumlah catatan untuk partisi apa pun di konsumen ini. |
| kafka\$1consumer\$1consumer\$1metrics\$1connection\$1count | Jumlah koneksi aktif saat ini. |
| kafka\$1consumer\$1consumer\$1metrics\$1incoming\$1byte\$1rate | Jumlah rata-rata byte yang diterima per detik dari semua server. |
| kafka\$1consumer\$1consumer\$1metrics\$1last\$1poll\$1seconds\$1ago | Jumlah detik sejak panggilan polling konsumen terakhir (). |
| kafka\$1consumer\$1consumer\$1metrics\$1request\$1rate | Jumlah permintaan yang dikirim per detik. |
| kafka\$1consumer\$1consumer\$1metrics\$1response\$1rate | Jumlah tanggapan yang diterima per detik. |
| kafka\$1consumer\$1group\$1 \$1Nilai ConsumerLagMetrics | Nilai lag konsumen saat ini untuk kelompok konsumen, menunjukkan seberapa jauh di belakang konsumen. |
| kafka\$1controller\$1 \$1Nilai KafkaController | Keadaan atau nilai pengontrol Kafka saat ini (1 = pengontrol aktif, 0 = tidak aktif). |
| kafka\$1controller\$1 \$1Hitung ControllerEventManager | Jumlah total peristiwa pengontrol yang diproses. |
| kafka\$1controller\$1 ControllerEventManager \$1Berarti | Rata-rata (rata-rata) waktu yang dibutuhkan untuk memproses peristiwa pengontrol. |
| kafka\$1controller\$1 \$1 ControllerStats MeanRate | Tingkat rata-rata operasi statistik pengontrol per detik. |
| kafka\$1coordinator\$1group\$1 \$1Nilai GroupMetadataManager | Status atau nilai manajer metadata grup saat ini untuk grup konsumen. |
| kafka\$1log\$1 \$1Hitung LogFlushStats | Jumlah total operasi log flush. |
| kafka\$1log\$1 LogFlushStats \$1Berarti | Rata-rata (rata-rata) waktu yang dibutuhkan untuk operasi log flush. |
| kafka\$1log\$1 \$1 LogFlushStats MeanRate | Tingkat rata-rata operasi log flush per detik. |
| kafka\$1network\$1 \$1Hitung RequestMetrics | Jumlah total permintaan jaringan yang diproses. |
| kafka\$1network\$1 RequestMetrics \$1Berarti | Rata-rata (rata-rata) waktu yang dibutuhkan untuk memproses permintaan jaringan. |
| RequestMetricskafka\$1jaringan\$1 \$1 MeanRate | Rata-rata tingkat permintaan jaringan per detik. |
| Kafka\$1network\$1Acceptor\$1 MeanRate | Tingkat rata-rata koneksi yang diterima per detik. |
| Kafka\$1Server\$1fetch\$1queue\$1size | Ukuran antrian permintaan pengambilan saat ini. |
| Kafka\$1Server\$1Produce\$1Queue\$1size | Ukuran antrian permintaan produksi saat ini. |
| Kafka\$1Server\$1Request\$1Queue\$1size | Ukuran antrian permintaan umum saat ini. |
| kafka\$1server\$1 \$1Hitung BrokerTopicMetrics | Jumlah total operasi topik broker (pesanin/out, bytes in/out). |
| kafka\$1server\$1 \$1 BrokerTopicMetrics MeanRate | Tingkat rata-rata operasi topik broker per detik. |
| kafka\$1server\$1 \$1 BrokerTopicMetrics OneMinuteRate | Tingkat rata-rata pergerakan satu menit dari operasi topik broker. |
| kafka\$1server\$1 \$1Nilai DelayedOperationPurgatory | Jumlah operasi tertunda saat ini di api penyucian (menunggu untuk diselesaikan). |
| kafka\$1server\$1 \$1 DelayedFetchMetrics MeanRate | Tingkat rata-rata operasi pengambilan tertunda per detik. |
| kafka\$1server\$1 \$1Nilai FetcherLagMetrics | Nilai lag saat ini untuk utas pengambil replika (seberapa jauh di belakang pemimpin). |
| kafka\$1server\$1 \$1 FetcherStats MeanRate | Tingkat rata-rata operasi fetcher per detik. |
| kafka\$1server\$1 \$1Nilai ReplicaManager | Status atau nilai manajer replika saat ini. |
| kafka\$1server\$1 \$1 ReplicaManager MeanRate | Tingkat rata-rata operasi manajer replika per detik. |
| kafka\$1server\$1 \$1byte\$1rate LeaderReplication | Tingkat byte direplikasi per detik untuk partisi di mana broker ini adalah pemimpin. |
| kafka\$1server\$1group\$1coordinator\$1metrics\$1group\$1completed\$1rebalance\$1count | Jumlah total penyeimbangan kembali kelompok konsumen yang diselesaikan. |
| kafka\$1server\$1group\$1coordinator\$1metrics\$1offset\$1commit\$1count | Jumlah total operasi komit offset. |
| kafka\$1server\$1group\$1coordinator\$1metrics\$1offset\$1commit\$1rate | Tingkat operasi komit offset per detik. |
| kafka\$1server\$1socket\$1server\$1metrics\$1connection\$1count | Jumlah koneksi aktif saat ini. |
| kafka\$1server\$1socket\$1server\$1metrics\$1connection\$1creation\$1rate | Tingkat pembuatan koneksi baru per detik. |
| kafka\$1server\$1socket\$1server\$1metrics\$1connection\$1close\$1rate | Tingkat penutupan koneksi per detik. |
| kafka\$1server\$1socket\$1server\$1metrics\$1failed\$1authentication\$1total | Jumlah total upaya otentikasi yang gagal. |
| kafka\$1server\$1socket\$1server\$1metrics\$1incoming\$1byte\$1rate | Tingkat byte masuk per detik. |
| kafka\$1server\$1socket\$1server\$1metrics\$1outgoing\$1byte\$1rate | Tingkat byte keluar per detik. |
| kafka\$1server\$1socket\$1server\$1metrics\$1request\$1rate | Tingkat permintaan per detik. |
| kafka\$1server\$1socket\$1server\$1metrics\$1response\$1rate | Tingkat respons per detik. |
| kafka\$1server\$1socket\$1server\$1metrics\$1network\$1io\$1rate | Tingkat I/O operasi jaringan per detik. |
| kafka\$1server\$1socket\$1server\$1metrics\$1io\$1ratio | Sebagian kecil waktu yang dihabiskan dalam I/O operasi. |
| kafka\$1server\$1controller\$1channel\$1metrics\$1connection\$1count | Jumlah koneksi aktif saat ini untuk saluran pengontrol. |
| kafka\$1server\$1controller\$1channel\$1metrics\$1incoming\$1byte\$1rate | Tingkat byte masuk per detik untuk saluran pengontrol. |
| kafka\$1server\$1controller\$1channel\$1metrics\$1outgoing\$1byte\$1rate | Tingkat byte keluar per detik untuk saluran pengontrol. |
| kafka\$1server\$1controller\$1channel\$1metrics\$1request\$1rate | Tingkat permintaan per detik untuk saluran pengontrol. |
| kafka\$1server\$1replica\$1fetcher\$1metrics\$1connection\$1count | Jumlah koneksi aktif saat ini untuk pengambil replika. |
| kafka\$1server\$1replica\$1fetcher\$1metrics\$1incoming\$1byte\$1rate | Tingkat byte masuk per detik untuk replika fetcher. |
| kafka\$1server\$1replica\$1fetcher\$1metrics\$1request\$1rate | Tingkat permintaan per detik untuk replika fetcher. |
| kafka\$1server\$1replica\$1fetcher\$1metrics\$1failed\$1authentication\$1total | Jumlah total upaya otentikasi gagal untuk pengambil replika. |
| kafka\$1server\$1 \$1Hitung ZooKeeperClientMetrics | Jumlah total operasi ZooKeeper klien. |
| kafka\$1server\$1 ZooKeeperClientMetrics \$1Berarti | Rata-rata latensi operasi ZooKeeper klien. |
| kafka\$1server\$1 \$1Nilai KafkaServer | Status atau nilai server Kafka saat ini (biasanya menunjukkan server sedang berjalan). |
| node\$1cpu\$1seconds\$1total | Total detik yang CPUs dihabiskan dalam setiap mode (pengguna, sistem, idle, dll.), Diuraikan berdasarkan CPU dan mode. |
| node\$1disk\$1read\$1bytes\$1total | Jumlah total byte yang berhasil dibaca dari disk, dipecah berdasarkan perangkat. |
| node\$1disk\$1reads\$1completed\$1total | Jumlah total pembacaan berhasil diselesaikan untuk disk, dipecah berdasarkan perangkat. |
| node\$1disk\$1writes\$1completed\$1total | Jumlah total penulisan berhasil diselesaikan untuk disk, dipecah berdasarkan perangkat. |
| node\$1disk\$1written\$1bytes\$1total | Jumlah total byte yang berhasil ditulis ke disk, dipecah berdasarkan perangkat. |
| node\$1filesystem\$1avail\$1bytes | Ruang sistem file yang tersedia dalam byte untuk pengguna non-root, dipecah berdasarkan perangkat dan titik pemasangan. |
| node\$1filesystem\$1size\$1bytes | Ukuran total sistem file dalam byte, dipecah berdasarkan perangkat dan titik pemasangan. |
| node\$1filesystem\$1free\$1bytes | Ruang sistem file gratis dalam byte, dipecah berdasarkan perangkat dan titik pemasangan. |
| node\$1filesystem\$1files | Jumlah total node file (inode) pada sistem file, dipecah berdasarkan perangkat dan titik pemasangan. |
| node\$1filesystem\$1files\$1free | Jumlah node file gratis (inode) pada sistem file, dipecah berdasarkan perangkat dan titik pemasangan. |
| node\$1filesystem\$1readonly | Menunjukkan apakah sistem file dipasang hanya-baca (1 = hanya-baca, 0 = baca-tulis). |
| node\$1filesystem\$1device\$1error | Menunjukkan apakah terjadi kesalahan saat mendapatkan statistik sistem file (1 = kesalahan, 0 = sukses). |
## Batasan
Integrasi MSK Amazon saat ini dengan Amazon Managed Service untuk Prometheus memiliki batasan berikut:
+ Hanya didukung untuk klaster Amazon MSK Provisioned (tidak tersedia untuk Amazon MSK Tanpa Server)
+ Tidak didukung untuk klaster MSK Amazon dengan akses publik diaktifkan dalam kombinasi dengan KRaft mode metadata
+ Tidak didukung untuk broker Amazon MSK Express
+ Saat ini mendukung pemetaan 1:1 antara kluster MSK Amazon dan Layanan Terkelola Amazon untuk kolektor/ruang kerja Prometheus
# Apa itu metrik yang kompatibel dengan Prometheus?
*Untuk mengikis metrik Prometheus dari aplikasi dan infrastruktur Anda untuk digunakan di Amazon Managed Service for Prometheus, metrik tersebut harus instrumen dan mengekspos metrik yang kompatibel dengan Prometheus dari titik akhir yang kompatibel dengan Prometheus.* `/metrics` Anda dapat menerapkan metrik Anda sendiri, tetapi Anda tidak harus melakukannya. Kubernetes (termasuk Amazon EKS) dan banyak pustaka dan layanan lainnya mengimplementasikan metrik ini secara langsung.
Saat metrik di Amazon EKS diekspor ke titik akhir yang kompatibel dengan Prometheus, metrik tersebut dapat dikikis secara otomatis oleh kolektor Layanan Terkelola Amazon untuk Prometheus.
Untuk informasi selengkapnya, lihat topik berikut:
+ [Untuk informasi selengkapnya tentang pustaka dan layanan yang ada yang mengekspor metrik sebagai metrik Prometheus, lihat Eksportir dan integrasi dalam dokumentasi Prometheus.](https://prometheus.io/docs/instrumenting/exporters/)
+ Untuk informasi selengkapnya tentang mengekspor metrik yang kompatibel dengan Prometheus dari kode Anda sendiri, lihat Menulis [eksportir](https://prometheus.io/docs/instrumenting/writing_exporters/) di dokumentasi Prometheus.
+ Untuk informasi selengkapnya tentang cara menyiapkan Layanan Terkelola Amazon untuk kolektor Prometheus untuk mengikis metrik dari kluster Amazon EKS Anda secara otomatis, lihat. [Siapkan kolektor terkelola untuk Amazon EKS](AMP-collector-how-to.md)
# Pantau kolektor dengan log penjual
Layanan Terkelola Amazon untuk kolektor Prometheus menyediakan log vended untuk membantu Anda memantau dan memecahkan masalah proses pengumpulan metrik. Log ini secara otomatis dikirim ke Amazon CloudWatch Logs dan memberikan visibilitas ke dalam penemuan layanan, pengumpulan metrik, dan operasi ekspor data. Kolektor menjual log untuk tiga komponen utama dari pipa pengumpulan metrik:
**Topics**
+ [Log penemuan layanan](#amp-collector-service-discovery-vended-logs)
+ [Log kolektor](#amp-collector-vended-logs)
+ [Log eksportir](#amp-exporter-vended-logs)
+ [Memahami dan menggunakan log penjual kolektor](#amp-collector-log-details)
## Log penemuan layanan
Log penemuan layanan memberikan informasi tentang proses penemuan target, termasuk:
+ Masalah autentikasi atau izin saat mengakses sumber daya API Kubernetes.
+ Kesalahan konfigurasi dalam pengaturan penemuan layanan.
Contoh berikut menunjukkan otentikasi umum dan kesalahan izin yang mungkin Anda temui selama penemuan layanan:
**Cluster Amazon EKS tidak ada**
Jika klaster Amazon EKS yang ditentukan tidak ada, Anda menerima kesalahan berikut:
```
{
"component": "SERVICE_DISCOVERY",
"timestamp": "2025-04-30T17:25:41.946Z",
"message": {
"log": "Failed to watch Service - Verify your scraper source exists."
},
"scrapeConfigId": "s-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
**Izin tidak valid untuk layanan**
Ketika kolektor tidak memiliki izin Kontrol Akses Berbasis Peran (RBAC) yang tepat untuk menonton Layanan, Anda menerima kesalahan ini:
```
{
"component": "SERVICE_DISCOVERY",
"timestamp": "2025-04-30T17:25:41.946Z",
"message": {
"log": "Failed to watch Service - Verify your scraper source permissions are valid."
},
"scrapeConfigId": "s-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
**Izin tidak valid untuk titik akhir**
Ketika kolektor tidak memiliki izin Kontrol Akses Berbasis Peran (RBAC) yang tepat untuk menonton Titik Akhir, Anda menerima kesalahan ini:
```
{
"component": "SERVICE_DISCOVERY",
"timestamp": "2025-04-30T17:25:41.946Z",
"message": {
"log": "Failed to watch Endpoints - Verify your scraper source permissions are valid."
},
"scrapeConfigId": "s-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
## Log kolektor
Log kolektor memberikan informasi tentang proses pengikisan metrik, termasuk:
+ Kegagalan gesekan karena titik akhir tidak tersedia.
+ Masalah koneksi saat mencoba mengikis target.
+ Batas waktu selama operasi pengikisan.
+ Kesalahan status HTTP dikembalikan oleh target scrape.
Contoh berikut menunjukkan kesalahan kolektor umum yang mungkin Anda temui selama proses pengikisan metrik:
**Titik akhir metrik tidak ada**
Ketika `/metrics` titik akhir tidak tersedia pada instance target, Anda menerima kesalahan ini:
```
{
"component": "COLLECTOR",
"message": {
"log": "Failed to scrape Prometheus endpoint - verify /metrics endpoint is available",
"job": "pod_exporter",
"targetLabels": "{__name__=\"up\", instance=\10.24.34.0\", job=\"pod_exporter\"}"
},
"timestamp": "1752787969551",
"scraperId": "s-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
**Koneksi ditolak**
Ketika kolektor tidak dapat membuat koneksi ke titik akhir target, Anda menerima kesalahan ini:
```
{
"scrapeConfigId": "s-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"timestamp": "2025-04-30T17:25:41.946Z",
"message": {
"message": "Scrape failed",
"scrape_pool": "pod_exporter",
"target": "http://10.24.34.0:80/metrics",
"error": "Get \"http://10.24.34.0:80/metrics\": dial tcp 10.24.34.0:80: connect: connection refused"
},
"component": "COLLECTOR"
}
```
## Log eksportir
Log eksportir memberikan informasi tentang proses pengiriman metrik yang dikumpulkan ke Layanan Terkelola Amazon Anda untuk ruang kerja Prometheus, termasuk:
+ Jumlah metrik dan titik data yang diproses.
+ Kegagalan ekspor karena masalah ruang kerja.
+ Kesalahan izin saat mencoba menulis metrik.
+ Kegagalan ketergantungan dalam pipa ekspor.
Contoh berikut menunjukkan kesalahan eksportir umum yang mungkin Anda temui selama proses ekspor metrik:
**Ruang kerja tidak ditemukan**
Ketika ruang kerja target untuk ekspor metrik tidak dapat ditemukan, Anda menerima kesalahan ini:
```
{
"component": "EXPORTER",
"message": {
"log": "Failed to export to the target workspace - Verify your scraper destination.",
"samplesDropped": 5
},
"timestamp": "1752787969664",
"scraperId": "s-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
## Memahami dan menggunakan log penjual kolektor
### Struktur log
Semua log penjual kolektor mengikuti struktur yang konsisten dengan bidang ini:
**scrapeConfigId**
Pengidentifikasi unik dari konfigurasi scrape yang menghasilkan log.
**stempel waktu**
Waktu ketika entri log dihasilkan.
**pesan**
Konten pesan log, yang mungkin mencakup bidang terstruktur tambahan.
**komponen**
Komponen yang menghasilkan log (SERVICE\$1DISCOVERY, COLLECTOR, atau EXPORTER)
### Menggunakan log vended untuk pemecahan masalah
Log penjual kolektor membantu Anda memecahkan masalah umum dengan pengumpulan metrik:
1. Masalah penemuan layanan
+ Periksa log **SERVICE\$1DISCOVERY** untuk otentikasi atau kesalahan izin.
+ Verifikasi bahwa kolektor memiliki izin yang diperlukan untuk mengakses sumber daya Kubernetes.
1. Masalah pengikisan metrik
+ Periksa log **COLLECTOR** untuk kegagalan gesekan.
+ Verifikasi bahwa titik akhir target dapat diakses dan mengembalikan metrik.
+ Pastikan bahwa aturan firewall memungkinkan kolektor untuk terhubung ke titik akhir target.
1. Masalah ekspor metrik
+ Periksa log **EKSPORTER** untuk kegagalan ekspor.
+ Verifikasi bahwa ruang kerja ada dan dikonfigurasi dengan benar.
+ Pastikan kolektor memiliki izin yang diperlukan untuk menulis ke ruang kerja.
### Mengakses log penjual kolektor
Log penjual kolektor secara otomatis dikirim ke Amazon CloudWatch Logs. Untuk mengakses log ini:
1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Pada panel navigasi, pilih **Grup log**.
1. Temukan dan pilih grup log untuk kolektor Anda:`/aws/prometheus/workspace_id/collector/collector_id`.
1. Jelajahi atau cari peristiwa log untuk menemukan informasi yang relevan.
Anda juga dapat menggunakan Wawasan CloudWatch Log untuk menanyakan dan menganalisis log kolektor Anda. Misalnya, untuk menemukan semua kesalahan penemuan layanan:
```
fields @timestamp, message.message
| filter component = "SERVICE_DISCOVERY" and message.message like /Failed/
| sort @timestamp desc
```
### Praktik terbaik untuk memantau kolektor
Untuk memantau Layanan Terkelola Amazon Anda secara efektif untuk kolektor Prometheus:
1. Siapkan CloudWatch alarm untuk masalah kolektor kritis, seperti kegagalan pengikisan persisten atau kesalahan ekspor. Untuk informasi selengkapnya, lihat [Alarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) di *Panduan CloudWatch Pengguna Amazon*.
1. Buat CloudWatch dasbor untuk memvisualisasikan metrik kinerja kolektor bersama data log yang dijual. Untuk informasi selengkapnya, lihat [Dasbor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) di *Panduan CloudWatch Pengguna Amazon*.
1. Tinjau log penemuan layanan secara teratur untuk memastikan target ditemukan dengan benar.
1. Pantau jumlah target yang dijatuhkan untuk mengidentifikasi potensi masalah konfigurasi.
1. Lacak kegagalan ekspor untuk memastikan metrik berhasil dikirim ke ruang kerja Anda.