

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

# Lacak pemanfaatan kapasitas kerja komputasi
<a name="track-capacity-utilization-compute-jobs"></a>

AWS Batch menyediakan beberapa operasi API yang dapat Anda gunakan bersama untuk melacak pemanfaatan kapasitas untuk pekerjaan komputasi ECS, EKS, dan Fargate dalam antrian. Alur kerja pemantauan tergantung pada jenis kebijakan penjadwalan yang dilampirkan ke antrian pekerjaan Anda.

Untuk antrian pekerjaan yang menggunakan kebijakan penjadwalan *first-in, first-out (FIFO*):

1. Periksa pemanfaatan antrian total ()`GetJobQueueSnapshot`.

1. Daftar pekerjaan berdasarkan status, seperti `RUNNABLE` dan `RUNNING` (`ListJobs`).

1. Periksa setiap pekerjaan yang diberikan (`DescribeJobs`).

Untuk antrian pekerjaan yang menggunakan kebijakan penjadwalan *fair-share (FSS)*:

1. Periksa pemanfaatan antrian total ()`GetJobQueueSnapshot`.

1. Lihat pemanfaatan per saham (). `GetJobQueueSnapshot`

1. Buat daftar pekerjaan berdasarkan status dan saham yang secara aktif berkontribusi pada pemanfaatan, seperti `RUNNABLE` dan `RUNNING` (`ListJobs`).

1. Periksa setiap pekerjaan yang diberikan (`DescribeJobs`).

Bagian berikut berjalan melalui setiap langkah secara rinci.

Untuk informasi tentang melacak pemanfaatan kapasitas untuk pekerjaan layanan, lihat[Lacak pemanfaatan kapasitas kerja layanan](track-capacity-utilization-service-jobs.md).

**Topics**
+ [Periksa pemanfaatan antrian](#capacity-utilization-snapshots-compute)
+ [Lihat pemanfaatan per saham](#share-utilization-monitoring-compute)
+ [Daftar pekerjaan komputasi berdasarkan status dan bagikan](#list-compute-jobs-by-share)
+ [Periksa pekerjaan komputasi tertentu](#examine-compute-job)

## Periksa pemanfaatan antrian
<a name="capacity-utilization-snapshots-compute"></a>

`queueUtilization`Bidang dalam [https://docs.aws.amazon.com/batch/latest/APIReference/API_GetJobQueueSnapshot.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_GetJobQueueSnapshot.html)respons memberikan point-in-time pandangan tentang berapa banyak kapasitas komputasi yang dikonsumsi oleh pekerjaan yang dikirim dari antrian. Kapasitas diukur dalam v CPUs untuk pekerjaan komputasi.

Untuk antrian pekerjaan yang menggunakan kebijakan penjadwalan pembagian adil, responsnya juga menyertakan rincian per saham sehingga Anda dapat melihat bagaimana kapasitas didistribusikan di seluruh saham. Untuk informasi selengkapnya, lihat [Lihat pemanfaatan per saham](#share-utilization-monitoring-compute).

### Lihat pemanfaatan kapasitas ()AWS CLI
<a name="capacity-snapshots-compute-cli"></a>

Gunakan [get-job-queue-snapshot](https://docs.aws.amazon.com/cli/latest/reference/batch/get-job-queue-snapshot.html)perintah untuk mengambil snapshot dari pemanfaatan kapasitas untuk antrian pekerjaan.

```
aws batch get-job-queue-snapshot \
    --job-queue {{my-job-queue}}
```

Responsnya bervariasi tergantung pada kebijakan penjadwalan yang dilampirkan pada antrian pekerjaan Anda. Pilih tab untuk jenis kebijakan penjadwalan Anda untuk melihat contoh respons.

------
#### [ First-in, first-out (FIFO) ]

Berikut ini adalah contoh respons untuk antrian pekerjaan FIFO yang menjalankan pekerjaan komputasi. Karena antrian FIFO tidak menggunakan kebijakan penjadwalan, responsnya tidak termasuk pemanfaatan per saham.

```
{
    "frontOfQueue": {
        "jobs": [],
        "lastUpdatedAt": 1700000000000
    },
    "queueUtilization": {
        "totalCapacityUsage": [
            {
                "capacityUnit": "vCPU",
                "quantity": 96.0
            }
        ],
        "lastUpdatedAt": 1700000000000
    }
}
```

Dalam contoh ini, antrian mengkonsumsi total 96 v CPUs di semua pekerjaan yang dikirim.

------
#### [ Fair-share scheduling (FSS) ]

Berikut ini adalah contoh respons untuk antrian pekerjaan berbagi adil. `queueUtilization`Objek berisi point-in-time snapshot dari total kapasitas yang dikonsumsi oleh semua pekerjaan yang dikirim dari antrian, bersama dengan rincian per saham.

```
{
    "frontOfQueue": {
        "jobs": [],
        "lastUpdatedAt": 1700000000000
    },
    "queueUtilization": {
        "totalCapacityUsage": [
            {
                "capacityUnit": "vCPU",
                "quantity": 192.0
            }
        ],
        "fairshareUtilization": {
            "activeShareCount": 2,
            "topCapacityUtilization": [
                {
                    "shareIdentifier": "team-a",
                    "capacityUsage": [
                        {
                            "capacityUnit": "vCPU",
                            "quantity": 128.0
                        }
                    ]
                },
                {
                    "shareIdentifier": "team-b",
                    "capacityUsage": [
                        {
                            "capacityUnit": "vCPU",
                            "quantity": 64.0
                        }
                    ]
                }
            ]
        },
        "lastUpdatedAt": 1700000000000
    }
}
```

Dalam contoh ini, `totalCapacityUsage` bidang menunjukkan bahwa antrian mengkonsumsi total 192 v. CPUs `fairshareUtilization`Objek menunjukkan rincian per saham. Bagian `team-a` mengkonsumsi 128 v CPUs dan saham `team-b` mengkonsumsi 64 v. CPUs

------

## Lihat pemanfaatan per saham
<a name="share-utilization-monitoring-compute"></a>

Untuk antrian pekerjaan dengan kebijakan penjadwalan berbagi adil, `queueUtilization` respons dari `GetJobQueueSnapshot` menyertakan `fairshareUtilization` objek dengan `topCapacityUtilization` larik yang mencantumkan pembagian aktif teratas berdasarkan konsumsi.

Informasi ini membantu Anda:
+ Identifikasi saham mana yang paling banyak mengkonsumsi sumber daya.
+ Verifikasi bahwa penjadwalan pembagian adil mendistribusikan sumber daya seperti yang diharapkan.
+ Mendeteksi saham yang mungkin jenuh atau kurang memanfaatkan alokasi mereka.
+ Tentukan apakah akan menyesuaikan bobot saham dalam kebijakan penjadwalan Anda.

Untuk informasi selengkapnya tentang kebijakan penjadwalan berbagi adil, lihat. [Kebijakan penjadwalan saham adil](job_scheduling.md)

## Daftar pekerjaan komputasi berdasarkan status dan bagikan
<a name="list-compute-jobs-by-share"></a>

Setelah Anda mengidentifikasi antrian keseluruhan dan pemanfaatan per saham, gunakan operasi [https://docs.aws.amazon.com/batch/latest/APIReference/API_ListJobs.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_ListJobs.html)API untuk menemukan pekerjaan komputasi yang secara aktif berkontribusi terhadap pemanfaatan. Anda dapat memfilter berdasarkan status pekerjaan untuk melihat pekerjaan yang`RUNNING`,`RUNNABLE`, atau di negara bagian lain. Untuk antrian dengan kebijakan penjadwalan berbagi adil, Anda juga dapat memfilter menurut pengenal berbagi untuk mempersempit hasil ke pembagian tertentu.

**catatan**  
`SHARE_IDENTIFIER`Filter adalah satu-satunya filter yang dapat dikombinasikan dengan `jobStatus` parameter. Bila Anda menggunakan filter lain, `jobStatus` parameter diabaikan.

### Daftar pekerjaan komputasi ()AWS CLI
<a name="list-compute-jobs-by-share-cli"></a>

Gunakan perintah [daftar-pekerjaan](https://docs.aws.amazon.com/cli/latest/reference/batch/list-jobs.html) dengan `--job-status` parameter untuk memfilter berdasarkan status.

Lihat menjalankan pekerjaan komputasi dalam antrian Anda:

```
aws batch list-jobs \
    --job-queue {{my-job-queue}} \
    --job-status RUNNING
```

Lihat pekerjaan komputasi yang menunggu untuk dikirim:

```
aws batch list-jobs \
    --job-queue {{my-job-queue}} \
    --job-status RUNNABLE
```

Untuk antrian dengan kebijakan penjadwalan berbagi adil, gunakan `--filters` parameter dengan daftar pekerjaan `SHARE_IDENTIFIER` untuk pembagian tertentu. Ini berguna ketika Anda mengidentifikasi bagian dengan konsumsi kapasitas tinggi dan ingin melihat pekerjaan mana yang bertanggung jawab.

Daftar hanya pekerjaan `RUNNING` komputasi untuk berbagi dari antrean berbagi adil:

```
aws batch list-jobs \
    --job-queue {{my-job-queue}} \
    --job-status RUNNING \
    --filters name=SHARE_IDENTIFIER,values="{{team-a}}"
```

Berikut ini adalah contoh respon untuk daftar menjalankan pekerjaan komputasi.

```
{
    "jobSummaryList": [
        {
            "jobArn": "arn:aws:batch:us-east-1:123456789012:job/b5e7d839-9ff9-5d76-9f3b-0b6f9g5c8e4f",
            "jobId": "b5e7d839-9ff9-5d76-9f3b-0b6f9g5c8e4f",
            "jobName": "my-data-processing-job",
            "status": "RUNNING",
            "shareIdentifier": "team-a",
            "createdAt": 1700000000000,
            "startedAt": 1700000120000,
            "capacityUsage": [
                {
                    "capacityUnit": "vCPU",
                    "quantity": 4.0
                }
            ],
            "container": {
                "exitCode": null
            },
            "jobDefinition": "arn:aws:batch:us-east-1:123456789012:job-definition/my-job-def:1"
        }
    ]
}
```

## Periksa pekerjaan komputasi tertentu
<a name="examine-compute-job"></a>

Setelah Anda mengidentifikasi pekerjaan komputasi yang diminati, gunakan [https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html)operasi untuk mendapatkan informasi lengkap tentang pekerjaan tersebut, termasuk statusnya saat ini, detail kontainer, dan konfigurasi sumber daya.

Lihat informasi rinci tentang pekerjaan komputasi tertentu:

```
aws batch describe-jobs \
    --jobs {{b5e7d839-9ff9-5d76-9f3b-0b6f9g5c8e4f}}
```

Perintah ini mengembalikan informasi komprehensif tentang pekerjaan, termasuk:
+ Job ARN dan status saat ini
+ Konfigurasi wadah dan persyaratan sumber daya (v CPUs dan memori)
+ Definisi pekerjaan dan detail lingkungan komputasi
+ Prioritas penjadwalan dan coba lagi konfigurasi
+ Informasi percobaan terperinci dengan waktu mulai dan berhenti
+ Informasi aliran log untuk mengakses log kontainer