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

Mengelola metrik armada

Topik ini menunjukkan cara menggunakan AWS IoT konsol dan AWS CLI mengelola metrik armada Anda.

Mengelola metrik armada (Konsol)

Bagian berikut menunjukkan cara menggunakan AWS IoT konsol untuk mengelola metrik armada Anda. Pastikan Anda telah mengaktifkan pengindeksan armada dengan sumber dan konfigurasi data terkait sebelum membuat metrik armada.

Aktifkan pengindeksan armada

Jika Anda telah mengaktifkan pengindeksan armada, lewati bagian ini.

Jika Anda belum mengaktifkan pengindeksan armada, ikuti petunjuk ini.

Buat metrik armada

Setelah pembuatan berhasil, metrik armada terdaftar di halaman metrik Armada.

Memperbarui metrik armada

Hapus metrik armada

Mengelola metrik armada (CLI)

Bagian berikut menunjukkan cara menggunakan metrik AWS CLI untuk mengelola armada Anda. Pastikan Anda telah mengaktifkan pengindeksan armada dengan sumber dan konfigurasi data terkait sebelum membuat metrik armada. Untuk mengaktifkan pengindeksan armada untuk hal-hal atau grup benda Anda, ikuti instruksi dalam Mengelola pengindeksan hal atau Mengelola pengindeksan grup hal.

Buat metrik armada

Anda dapat menggunakan perintah create-fleet-metric CLI untuk membuat metrik armada.

aws iot create-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 60 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum

Output dari perintah ini berisi nama dan Amazon Resource Name (ARN) dari metrik armada Anda. Outputnya terlihat seperti berikut:

{
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "metricName": "YourFleetMetricName"
}

Daftar metrik armada

Anda dapat menggunakan perintah list-fleet-metric CLI untuk mencantumkan semua metrik armada di akun Anda.

aws iot list-fleet-metrics

Output dari perintah ini berisi semua metrik armada Anda. Outputnya terlihat seperti berikut:

{
    "fleetMetrics": [
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric1", 
            "metricName": "YourFleetMetric1"
        }, 
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric2", 
            "metricName": "YourFleetMetric2"
        }
    ]
}

Jelaskan metrik armada

Anda dapat menggunakan perintah describe-fleet-metric CLI untuk menampilkan informasi lebih rinci tentang metrik armada.

aws iot describe-fleet-metric --metric-name "YourFleetMetricName"

Output dari perintah berisi informasi rinci tentang metrik armada yang ditentukan. Outputnya terlihat seperti berikut:

{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625790642.355, 
    "queryString": "*", 
    "period": 60, 
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "aggregationField": "registry.version", 
    "version": 1, 
    "aggregationType": {
        "values": [
            "sum"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625790642.355, 
    "metricName": "YourFleetMetricName"
}

Memperbarui metrik armada

Anda dapat menggunakan perintah update-fleet-metric CLI untuk memperbarui metrik armada.

aws iot update-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 120 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum,count --index-name AWS_Things

update-fleet-metric Perintah tidak menghasilkan output apa pun. Anda dapat menggunakan perintah describe-fleet-metric CLI untuk melihat hasilnya.

{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625792300.881, 
    "queryString": "*", 
    "period": 120, 
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "aggregationField": "registry.version", 
    "version": 2, 
    "aggregationType": {
        "values": [
            "sum", 
            "count"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625792300.881, 
    "metricName": "YourFleetMetricName"
}

Hapus metrik armada

Gunakan perintah delete-fleet-metric CLI untuk menghapus metrik armada.

aws iot delete-fleet-metric --metric-name "YourFleetMetricName"

Perintah ini tidak menghasilkan output apa pun jika penghapusan berhasil atau jika Anda menentukan metrik armada yang tidak ada.

Untuk informasi selengkapnya, lihat Memecahkan masalah metrik armada.

Otorisasi penandaan sumber daya IoT

Untuk kontrol yang lebih baik atas metrik armada yang dapat Anda buat, modifikasi, atau gunakan, Anda dapat melampirkan tag ke metrik armada.

Untuk menandai metrik armada yang Anda buat dengan menggunakan AWS Management Console atau AWS CLI, Anda harus menyertakan iot:TagResource tindakan dalam kebijakan IAM untuk memberikan izin kepada pengguna. Jika kebijakan IAM Anda tidak disertakaniot:TagResource, tindakan apa pun untuk membuat metrik armada dengan tag akan menampilkan AccessDeniedException kesalahan.

Untuk informasi umum tentang menandai sumber daya Anda, lihat Menandai sumber daya Anda AWS IoT.

Contoh kebijakan IAM

Lihat contoh kebijakan IAM berikut yang memberikan izin penandaan saat Anda membuat metrik armada:

{
	"Version": "2012-10-17",
	"Statement": [
		{
			"Action": [
				"iot:TagResource"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		},
		{
			"Action": [
				"iot:CreateFleetMetric"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:index/*",
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		}
	]
}

Untuk informasi lebih lanjut, lihat Tindakan, sumber daya, kunci syarat untuk AWS IoT.