Data agregat dari properti dan aset lainnya (metrik) - AWS IoT SiteWise
Tentukan metrik (konsol)Tentukan metrik ()AWS CLI

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

Data agregat dari properti dan aset lainnya (metrik)

Metrik adalah ekspresi matematika yang menggunakan fungsi agregasi untuk memproses semua titik data input dan output satu titik data per interval waktu tertentu. Misalnya, metrik dapat menghitung suhu rata-rata per jam dari aliran data suhu.

Metrik dapat memasukkan data dari metrik aset terkait, sehingga Anda dapat menghitung statistik yang memberikan wawasan tentang operasi atau subset operasi Anda. Misalnya, metrik dapat menghitung suhu rata-rata per jam di semua turbin angin di ladang angin. Untuk informasi selengkapnya tentang cara mendefinisikan asosiasi antar aset, lihatTentukan hierarki model aset.

Metrik juga dapat memasukkan data dari properti lain tanpa menggabungkan data setiap interval waktu. Jika Anda menentukan atribut dalam rumus, AWS IoT SiteWise gunakan nilai terbaru untuk atribut tersebut saat menghitung rumus. Jika Anda menentukan metrik dalam rumus, AWS IoT SiteWise gunakan nilai terakhir untuk interval waktu di mana ia menghitung rumus. Ini berarti Anda dapat menentukan metrik sepertiOEE = Availability * Quality * Performance, di manaAvailability,Quality, dan Performance semua metrik lain pada model aset yang sama.

AWS IoT SiteWise juga secara otomatis menghitung satu set metrik agregasi dasar untuk semua properti aset. Untuk mengurangi biaya komputasi, Anda dapat menggunakan agregat ini alih-alih mendefinisikan metrik khusus untuk perhitungan dasar. Untuk informasi selengkapnya, lihat Agregat properti aset kueri.

Tentukan metrik (konsol)

Saat menentukan metrik untuk model aset di AWS IoT SiteWise konsol, Anda menentukan parameter berikut:

  • Nama - Nama properti.

  • Tipe data — Tipe data dari transformasi, yang dapat berupa Double atau String.

  • ID Eksternal — (Opsional) Ini adalah ID yang ditentukan pengguna. Untuk informasi selengkapnya, lihat Referensi objek dengan eksternal IDs di AWS IoT SiteWise Panduan Pengguna.

  • Rumus — Ekspresi metrik. Ekspresi metrik dapat menggunakan fungsi agregasi untuk memasukkan data dari properti untuk semua aset terkait dalam hierarki. Mulai mengetik atau tekan tombol panah bawah untuk membuka fitur auto complete. Untuk informasi selengkapnya, lihat Gunakan ekspresi rumus.

    penting

    Metrik hanya dapat berupa properti yang integer, double, Boolean, atau tipe string. Boolean mengkonversi ke 0 (false) dan 1 (true).

    Jika Anda menentukan variabel input metrik apa pun dalam ekspresi metrik, input tersebut harus memiliki interval waktu yang sama dengan metrik keluaran.

    Ekspresi rumus hanya dapat menampilkan nilai ganda atau string. Ekspresi bersarang dapat menampilkan tipe data lain, seperti string, tetapi rumus secara keseluruhan harus mengevaluasi ke angka atau string. Anda dapat menggunakan fungsi jp untuk mengonversi string ke angka. Nilai Boolean harus 1 (true) atau 0 (false). Untuk informasi selengkapnya, lihat Nilai tidak terdefinisi, tak terbatas, dan meluap.

  • Interval waktu — Interval waktu metrik. AWS IoT SiteWise mendukung interval waktu jendela jatuh berikut, di mana setiap interval dimulai ketika yang sebelumnya berakhir:

    • 1 menit — 1 menit, dihitung pada akhir setiap menit (12:00:00 AM, 12:01:00 AM, 12:02:00 AM, dan seterusnya).

    • 5 menit — 5 menit, dihitung pada akhir setiap lima menit dimulai pada jam (12:00:00, 12:05:00 AM, 12:10:00 AM, dan seterusnya).

    • 15 menit — 15 menit, dihitung pada akhir setiap lima belas menit dimulai pada jam (12:00:00 AM, 12:15:00 AM, 12:30:00 AM, dan seterusnya).

    • 1 jam — 1 jam (60 menit), dihitung pada akhir setiap jam di UTC (12:00:00 AM, 01:00:00 AM, 02:00:00 AM, dan seterusnya).

    • 1 hari — 1 hari (24 jam), dihitung pada akhir setiap hari di UTC (12:00:00 Senin, 12:00:00 Selasa, dan seterusnya).

    • 1 minggu — 1 minggu (7 hari), dihitung pada akhir setiap hari Minggu di UTC (setiap 12:00:00 Senin).

    • Interval khusus - Anda dapat memasukkan interval waktu antara satu menit dan seminggu.

  • Tanggal offset — (Opsional) Tanggal referensi untuk mengumpulkan data.

  • Waktu offset — (Opsional) Waktu referensi untuk mengumpulkan data. Waktu offset harus antara 00:00:00 dan 23:59:59.

  • Offset zona waktu - (Opsional) Zona waktu untuk offset. Jika tidak ditentukan, zona waktu offset default adalah Universal Coordinated Time ()UTC.

    • (UTC+ 00:00) Waktu Terkoordinasi Universal

    • (UTC+ 01:00) Waktu Tengah Eropa

    • (UTC+ 02:00) Eropa Timur

    • (UTC03+:00) Waktu Afrika Timur

    • (UTC+ 04:00) Waktu Timur Dekat

    • (UTC+ 05:00) Waktu Lahore Pakistan

    • (UTC+ 05:30) Waktu Standar India

    • (UTC+ 06:00) Waktu Standar Bangladesh

    • (UTC+ 07:00) Waktu Standar Vietnam

    • (UTC+ 08:00) Waktu China Taiwan

    • (UTC+ 09:00) Waktu Standar Jepang

    • (UTC+ 09:30) Waktu Tengah Australia

    • (UTC+ 10:00) Waktu Timur Australia

    • (UTC+ 11:00) Waktu Standar Solomon

    • (UTC+ 12:00) Waktu Standar Selandia Baru

    • (UTC- 11:00) Waktu Kepulauan Midway

    • (UTC- 10:00) Waktu Standar Hawaii

    • (UTC- 09:00) Waktu Standar Alaska

    • (UTC- 08:00) Waktu Standar Pasifik

    • (UTC- 07:00) Waktu Standar Phoenix

    • (UTC- 06:00) Waktu Standar Pusat

    • (UTC- 05:00) Waktu Standar Timur

    • (UTC- 04:00) Puerto Riko dan Waktu Kepulauan Virgin AS

    • (UTC- 03:00) Waktu Standar Argentina

    • (UTC- 02:00) Waktu Georgia Selatan

    • (UTC- 01:00) Waktu Afrika Tengah

contoh interval waktu khusus dengan offset (konsol)

Contoh berikut menunjukkan kepada Anda cara menentukan interval waktu 12 jam dengan offset pada 20 Februari 2021, pukul 18:30:30 (). PST

Untuk menentukan interval kustom dengan offset

  1. Untuk Interval waktu, pilih Interval khusus.

  2. Untuk Interval waktu, lakukan salah satu hal berikut:

    • Masuk12, lalu pilih jam.

    • Masuk720, lalu pilih menit.

    • Masukkan43200, lalu pilih detik.

    penting

    Interval waktu harus berupa bilangan bulat terlepas dari unit.

  3. Untuk tanggal Offset, pilih 2021/02/20.

  4. Untuk waktu Offset, masukkan18:30:30.

  5. Untuk zona waktu Offset, pilih (UTC- 08:00) Waktu Standar Pasifik.

Jika Anda membuat metrik pada 1 Juli 2021, sebelum atau pukul 18.30:30 (PST), Anda mendapatkan hasil agregasi pertama pada 1 Juli 2021, pukul 18.30:30 (). PST Hasil agregasi kedua adalah pada 2 Juli 2021 pukul 06.30:30 PST WIB, dan seterusnya.

Tentukan metrik ()AWS CLI

Saat Anda menentukan metrik untuk model aset dengan AWS IoT SiteWise API, Anda menentukan parameter berikut:

  • name- Nama properti.

  • dataType— Tipe data metrik, yang bisa DOUBLE atauSTRING.

  • externalId— (Opsional) Ini adalah ID yang ditentukan pengguna. Untuk informasi selengkapnya, lihat Referensi objek dengan eksternal IDs di AWS IoT SiteWise Panduan Pengguna.

  • expressionEkspresi metrik. Ekspresi metrik dapat menggunakan fungsi agregasi untuk memasukkan data dari properti untuk semua aset terkait dalam hierarki. Untuk informasi selengkapnya, lihat Gunakan ekspresi rumus.

  • window— Interval waktu dan offset untuk jendela jatuh metrik, di mana setiap interval dimulai ketika yang sebelumnya berakhir:

    • interval— Interval waktu untuk jendela jatuh. Interval waktu harus antara satu menit dan seminggu.

    • offsets— Offset untuk jendela yang jatuh.

    Untuk informasi lebih lanjut, lihat TumblingWindowdi AWS IoT SiteWise APIReferensi.

    contoh interval waktu kustom dengan offset ()AWS CLI

    Contoh berikut menunjukkan kepada Anda cara menentukan interval waktu 12 jam dengan offset pada 20 Februari 2021, pukul 06:30:30 (). PST

    
{
    "window": {
        "tumbling": {
            "interval": "12h",
            "offset": " 2021-07-23T18:30:30-08"
        }
    }
}

    Jika Anda membuat metrik pada 1 Juli 2021, sebelum atau pukul 18.30:30 (PST), Anda mendapatkan hasil agregasi pertama pada 1 Juli 2021, pukul 18.30:30 (). PST Hasil agregasi kedua adalah pada 2 Juli 2021 pukul 06.30:30 PST WIB, dan seterusnya.

  • variables— Daftar variabel yang mendefinisikan properti lain dari aset atau aset anak Anda untuk digunakan dalam ekspresi. Setiap struktur variabel berisi nama sederhana untuk digunakan dalam ekspresi dan value struktur yang mengidentifikasi properti mana yang akan ditautkan ke variabel tersebut. valueStruktur berisi informasi berikut:

    • propertyId— ID properti dari mana untuk menarik nilai. Anda dapat menggunakan nama properti alih-alih ID-nya jika properti didefinisikan dalam model saat ini (bukan didefinisikan dalam model dari hierarki).

    • hierarchyId— (Opsional) ID hierarki untuk menanyakan aset turunan untuk properti. Anda dapat menggunakan nama definisi hierarki alih-alih ID-nya. Jika Anda menghilangkan nilai ini, AWS IoT SiteWise temukan properti dalam model saat ini.

    penting

    Metrik hanya dapat berupa properti yang integer, double, Boolean, atau tipe string. Boolean mengkonversi ke 0 (false) dan 1 (true).

    Jika Anda menentukan variabel input metrik apa pun dalam ekspresi metrik, input tersebut harus memiliki interval waktu yang sama dengan metrik keluaran.

    Ekspresi rumus hanya dapat menampilkan nilai ganda atau string. Ekspresi bersarang dapat menampilkan tipe data lain, seperti string, tetapi rumus secara keseluruhan harus mengevaluasi ke angka atau string. Anda dapat menggunakan fungsi jp untuk mengonversi string ke angka. Nilai Boolean harus 1 (true) atau 0 (false). Untuk informasi selengkapnya, lihat Nilai tidak terdefinisi, tak terbatas, dan meluap.

  • unit— (Opsional) Unit ilmiah untuk properti, seperti mm atau Celcius.

contoh Contoh definisi metrik

Contoh berikut menunjukkan properti metrik yang mengumpulkan data pengukuran suhu aset untuk menghitung suhu per jam maksimum di Fahrenheit. Objek ini adalah contoh dari sebuah AssetModelPropertyyang berisi Metrik. Anda dapat menentukan objek ini sebagai bagian dari payload CreateAssetModelpermintaan untuk membuat properti metrik. Untuk informasi selengkapnya, lihat Buat model aset (AWS CLI).


{
      ...
      "assetModelProperties": [
      ...
      {
        "name": "Max temperature",
        "dataType": "DOUBLE",
        "type": {
          "metric": {
            "expression": "max(temp_f)",
            "variables": [
              {
                "name": "temp_f",
                "value": {
                  "propertyId": "Temperature F"
                }
              }
            ],
            "window": {
              "tumbling": {
                "interval": "1h"
              }
            }
          }
        },
        "unit": "Fahrenheit"
      }
    ],
    ...
}
contoh Contoh definisi metrik yang memasukkan data dari aset terkait

Contoh berikut menunjukkan properti metrik yang mengumpulkan beberapa data daya rata-rata turbin angin untuk menghitung total daya rata-rata untuk ladang angin. Objek ini adalah contoh dari sebuah AssetModelPropertyyang berisi Metrik. Anda dapat menentukan objek ini sebagai bagian dari payload CreateAssetModelpermintaan untuk membuat properti metrik. 

{
      ...
      "assetModelProperties": [
      ...
      {
          "name": "Total Average Power",
          "dataType": "DOUBLE",
          "type": {
            "metric": {
              "expression": "avg(power)",
              "variables": [
                {
                  "name": "power",
                  "value": {
                    "propertyId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
                    "hierarchyId": "Turbine Asset Model"
                  }
                }
              ],
              "window": {
                "tumbling": {
                  "interval": "5m"
                }
              }
            }
        },
        "unit": "kWh"
      }
    ],
    ...
}