View a markdown version of this page

GetSeries - Amazon CloudWatch
Parameter kueri URLIzin IAM yang diperlukanBatas hasilPermintaan sampelRespons sampel

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

GetSeries

GetSeriesOperasi mengembalikan daftar deret waktu yang labelnya cocok dengan satu atau lebih pemilih.

Kata kerja HTTP yang valid

GET, POST

URI yang valid

/api/v1/series

URL permintaan lengkap menggabungkan host CloudWatch pemantauan untuk AWS Wilayah dengan jalur operasi, misalnyahttps://monitoring.AWS Region.amazonaws.com/api/v1/series. Untuk informasi tentang titik akhir, penandatanganan, dan izin IAM yang diperlukan, lihat. Kueri PromQL

Parameter kueri URL

Parameter berikut diteruskan dalam string kueri URL untuk GET permintaan, atau sebagai bidang isi yang dikodekan formulir untuk permintaan. POST

Parameter Deskripsi

match[]

Wajib. Pemilih seri yang menyaring deret waktu untuk kembali. Setiap pemilih harus menyertakan pencocokan persis (=) pada nama metrik — misalnya, {"http.server.active_requests"} atau{__name__="http.server.active_requests"}. Selector tanpa metric-name equal matcher tidak didukung. Selain kecocokan persis, pencocokan label juga mendukung not equal (!=), regex match (), dan negative regex match (=~). !~ Tentukan match[] satu kali atau lebih untuk menggabungkan penyeleksi. Untuk informasi selengkapnya tentang sintaks pemilih, lihat. Kueri PromQL

start

Wajib. Mulai dari rentang waktu untuk dipertimbangkan, sebagai stempel waktu RFC 3339 atau stempel waktu Unix.

end

Wajib. Akhir rentang waktu yang perlu dipertimbangkan, sebagai stempel waktu RFC 3339 atau stempel waktu Unix.

limit

Tidak wajib. Jumlah maksimum deret waktu unik untuk dikembalikan, dari 1 ke10000. Jika Anda tidak menentukanlimit, CloudWatch mengembalikan hingga maksimum (10.000). Lihat Batas hasil.

Izin IAM yang diperlukan

Untuk meneleponGetSeries, identitas panggilan harus memiliki tindakan IAM berikut:

  • cloudwatch:ListMetrics

Untuk pemetaan tindakan IAM lengkap untuk semua operasi PromQL, lihat. Izin IAM untuk PromQL

Batas hasil

Satu /api/v1/series respons dapat mengembalikan hingga 10.000 deret waktu unik. Untuk meminta hasil yang lebih sedikit, berikan limit parameter dengan nilai dari 1 ke10000. Jika Anda tidak menentukanlimit, CloudWatch kembali hingga maksimum.

Ketika seri yang cocok melebihi batas, respons terpotong dan pesan disertakan dalam bidang Prometheus standar. warnings Kode status HTTP tetap ada200.

Untuk daftar lengkap batas PromQL, termasuk TPS, konkurensi, dan jendela pemindaian 24 jam, lihat. Batas dan batasan PromQL

Permintaan sampel

POSTPermintaan berikut menggunakan pemilih kecocokan persis. Pemilih,start, dan diteruskan sebagai bidang end yang dikodekan formulir di badan permintaan. Karakter khusus seperti{,, }", dan , dikodekan persen. match[]Nilai decoded adalah. {"http.server.active_requests","@resource.service.name"="myservice"}

POST /api/v1/series HTTP/1.1
Host: monitoring.us-east-1.amazonaws.com
Content-Type: application/x-www-form-urlencoded
Authorization: AUTHPARAMS
X-Amz-Date: 20260605T193725Z
User-Agent: awscurl/0.36

match%5B%5D=%7B%22http.server.active_requests%22%2C%22%40resource.service.name%22%3D%22myservice%22%7D&start=1780662000&end=1780665600

POSTPermintaan berikut menggunakan pemilih kecocokan regex. match[]Nilai decoded adalah. {"http.server.active_requests","@aws.region"=~"us-.*"}

POST /api/v1/series HTTP/1.1
Host: monitoring.us-east-1.amazonaws.com
Content-Type: application/x-www-form-urlencoded
Authorization: AUTHPARAMS
X-Amz-Date: 20260605T193725Z
User-Agent: awscurl/0.36

match%5B%5D=%7B%22http.server.active_requests%22%2C%22%40aws.region%22%3D~%22us-.*%22%7D&start=1780662000&end=1780665600

Panggilan yang sama denganawscurl:

awscurl --service monitoring --region us-east-1 \
    -X POST 'https://monitoring.us-east-1.amazonaws.com/api/v1/series' \
    -H 'Content-Type: application/x-www-form-urlencoded' \
    -d 'match[]={"http.server.active_requests","@aws.region"=~"us-.*"}&start=1780662000&end=1780665600'

Respons sampel

Respons yang berhasil menggunakan amplop Prometheus JSON standar. dataBidang ini adalah array peta label, satu per seri yang cocok.

HTTP/1.1 200 OK
x-amzn-RequestId: 12345678-abcd-4442-b8c5-262b45e9b535
Content-Type: application/json

{
    "status": "success",
    "data": [
        {
            "__name__": "http.server.active_requests",
            "@resource.service.name": "myservice",
            "@aws.region": "us-east-1"
        },
        {
            "__name__": "http.server.active_requests",
            "@resource.service.name": "myservice",
            "@aws.region": "us-west-2"
        }
    ]
}