View a markdown version of this page

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 memberikan output berupa satu titik data per interval waktu yang ditentukan. 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 Anda 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 mengumpulkan data selama setiap interval waktu. Jika Anda menentukan atribut dalam rumus, AWS IoT SiteWise menggunakan nilai terbaru untuk atribut tersebut saat menghitung rumus. Jika Anda menentukan metrik dalam rumus, AWS IoT SiteWise menggunakan nilai terakhir untuk interval waktu di mana ia menghitung rumus. Ini berarti Anda dapat menentukan metrik seperti OEE = Availability * Quality * PerformanceAvailability, di manaQuality, dan Performance semua metrik lainnya 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 menentukan metrik khusus untuk perhitungan dasar. Untuk informasi selengkapnya, lihat Kueri agregat properti aset di AWS IoT SiteWise.

Tentukan metrik (konsol)

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

  • Nama — Nama properti.

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

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

  • Formula — 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 lengkap otomatis. Untuk informasi selengkapnya, lihat Gunakan ekspresi rumus.

    penting

    Metrik hanya dapat berupa properti yang berupa integer, double, Boolean, atau tipe string. Boolean dikonversi 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 dievaluasi ke angka atau string. Anda dapat menggunakan fungsi jp untuk mengubah string menjadi angka. Nilai Boolean harus 1 (benar) atau 0 (salah). Untuk informasi selengkapnya, lihat Nilai tidak ditentukan, tak terbatas, dan meluap.

  • Interval waktu — Interval waktu metrik. AWS IoT SiteWise mendukung interval waktu jendela tumbling 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 mulai jam (12:00:00 AM, 12:05:00 AM, 12:10:00 AM, dan seterusnya).

    • 15 menit — 15 menit, dihitung pada akhir setiap lima belas menit mulai jam tersebut (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 AM Selasa, dan seterusnya).

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

    • Interval kustom - Anda dapat memasukkan interval waktu antara satu menit dan satu minggu.

  • 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.

  • Zona waktu offset — (Opsional) Zona waktu untuk offset. Jika tidak ditentukan, zona waktu offset default adalah Waktu Terkoordinasi Universal (UTC). Lihat zona waktu yang didukung berikut ini.

  • (UTC+ 00:00) Waktu Terkoordinasi Universal

  • (UTC+ 01:00) Waktu Eropa Tengah

  • (UTC+ 02:00) Eropa Timur

  • (UTC03+:00) Waktu Afrika Timur

  • (UTC+ 04:00) Waktu Timur Dekat

  • (UTC+ 05:00) Waktu Pakistan Lahore

  • (UTC+ 05:30) Waktu Standar India

  • (UTC+ 06:00) Waktu Standar Bangladesh

  • (UTC+ 07:00) Waktu Standar Vietnam

  • (UTC+ 08:00) China Taiwan Waktu Taipei

  • (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 Tengah

  • (UTC-05:00) Waktu Standar Timur

  • (UTC-04:00) Waktu Puerto Riko dan 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 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 kustom.

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

    • Masukkan12, lalu pilih jam.

    • Masukkan720, lalu pilih menit.

    • Masukkan43200, lalu pilih detik.

    penting

    Interval waktu harus berupa bilangan bulat terlepas dari unitnya.

  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 06:30:30 (PST), Anda mendapatkan hasil agregasi pertama pada 1 Juli 2021, pukul 06:30:30 (PST). Hasil agregasi kedua adalah pada 2 Juli 2021, pukul 06:30:30 (PST), 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— Jenis data dari metrik, yang bisa DOUBLE atauSTRING.

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

  • expression— Ekspresi 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 tumbling metrik, di mana setiap interval dimulai ketika yang sebelumnya berakhir:

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

    • offsets— Offset untuk jendela yang jatuh.

    Untuk informasi selengkapnya, lihat TumblingWindow di dalam Referensi API AWS IoT SiteWise .

    contoh interval waktu khusus dengan offset (AWS CLI)

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

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

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

  • variablesDaftar 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 itu. 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 tempat menanyakan aset anak untuk properti. Anda dapat menggunakan nama definisi hierarki alih-alih ID-nya. Jika Anda menghilangkan nilai ini, AWS IoT SiteWise menemukan properti dalam model saat ini.

    penting

    Metrik hanya dapat berupa properti yang berupa integer, double, Boolean, atau tipe string. Boolean dikonversi 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 dievaluasi ke angka atau string. Anda dapat menggunakan fungsi jp untuk mengubah string menjadi angka. Nilai Boolean harus 1 (benar) atau 0 (salah). Untuk informasi selengkapnya, lihat Nilai tidak ditentukan, tak terbatas, dan meluap.

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

contoh Contoh definisi metrik

Contoh berikut menunjukkan properti metrik yang menggabungkan data pengukuran suhu aset untuk menghitung suhu maksimum per jam dalam Fahrenheit. Objek ini adalah contoh AssetModelProperty yang berisi Metrik. Anda dapat menentukan objek ini sebagai bagian dari pay CreateAssetModel load permintaan 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 menggabungkan data daya rata-rata beberapa turbin angin untuk menghitung daya rata-rata total untuk ladang angin. Objek ini adalah contoh AssetModelProperty yang berisi Metrik. Anda dapat menentukan objek ini sebagai bagian dari pay CreateAssetModel load permintaan 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"
      }
    ],
    ...
}