Konfigurasi dasar

Deployment Manufacturing Data Engine (MDE) standar tidak menerapkan setelan konfigurasi apa pun secara default, yang diperlukan untuk mulai memproses data.

Panduan ini akan memandu Anda melakukan penyiapan MDE dasar. Misalnya, untuk menguji apakah sistem berfungsi secara menyeluruh. Dengan panduan ini, Anda dapat membuat class, jenis, dan parser pesan untuk ketiga Arketipe.

Jika Anda ingin menggunakan edge Manufacturing Connect (MCe) untuk menyerap data, deploy paket konfigurasi default sebagai gantinya.

Anda dapat menggunakan MDE API atau antarmuka web untuk menyelesaikan konfigurasi ini.

Catatan: Untuk menggunakan API, Anda harus mengonfigurasi tunneling SSH melalui IAP sebelumnya.

Peringatan: Konfigurasi ini tidak ditujukan untuk kasus penggunaan produksi. Selalu sesuaikan konfigurasi Anda dengan kasus penggunaan tertentu.

Class pesan

Bagian ini memberikan contoh class pesan yang tersedia di MDE.

Penting: Mulai rilis MDE 1.4.1, header pesan disimpan dalam atribut khusus yang disebut mdeHeaders. Kelas pesan yang ada yang menggunakan ekspresi seperti #root.headers['SOME_ATTRIBUTE'] akan terus berfungsi untuk beberapa rilis mendatang sebelum tidak digunakan lagi. Pastikan Anda memperbarui ekspresi class pesan untuk menggunakan #root.mdeHeaders['SOME_ATTRIBUTE'].

Class pesan untuk numeric

Berikut adalah contoh class pesan basic-numeric:

REST

POST /configuration/v1/message-classes

{
   "name": "basic-numeric",
   "priority": 2000,
   "expression": "#root.event['value'] instanceof T(Number) && #root.event['timestamp'] != null && #root.event['tagName'] != null"
}

Antarmuka web

Nama Kelas Pesan: basic-numeric

1. Di antarmuka web MDE, klik Message Classes.
2. Klik Tambahkan Message Class baru.
3. Isi Message Class name sebagai basic-numeric.

4. Salin ekspresi berikut dan tempelkan ke kotak Expression:

      #root.event['value'] instanceof T(Number) && #root.event['timestamp'] != null && #root.event['tagName'] != null
   

5. Ubah prioritas menjadi 2000.

6. Klik Create.

   

Class pesan untuk discrete

Berikut adalah contoh class pesan basic-discrete:

REST

POST /configuration/v1/message-classes

   {
      "name": "basic-discrete",
      "priority": 1975,
      "expression": "#root.event['value'] != null && !(#root.event['value'] instanceof T(Number)) && #root.event['timestamp'] != null && #root.event['tagName'] != null"
   }

Antarmuka web

Nama Kelas Pesan: basic-discrete

1. Di antarmuka web MDE, klik Message Classes.
2. Klik Tambahkan Message Class baru.
3. Isi Message Class name sebagai basic-discrete.

4. Salin ekspresi berikut dan tempelkan ke kotak Expression:

      #root.event['value'] != null && !(#root.event['value'] instanceof T(Number)) && #root.event['timestamp'] != null  && #root.event['tagName'] != null
   

5. Ubah prioritas menjadi 1975.

6. Klik Create.

   

Class pesan untuk continuous

Berikut adalah contoh class pesan basic-continuous:

REST

POST /configuration/v1/message-classes

   {
      "name": "basic-continuous",
      "priority": 1950,
      "expression": "#root.event['value'] != null && !(#root.event['value'] instanceof T(Number)) && #root.event['startTimestamp'] != null && #root.event['endTimestamp'] != null && #root.event['tagName'] != null"
   }

Antarmuka web

Nama Kelas Pesan: basic-continuous

1. Di antarmuka web MDE, klik Message Classes.
2. Klik Tambahkan Message Class baru.
3. Isi Message Class name sebagai basic-continuous.

4. Salin ekspresi berikut dan tempelkan ke kotak Expression:

   #root.event['value'] != null && !(#root.event['value'] instanceof T(Number)) && #root.event['startTimestamp'] != null && #root.event['endTimestamp'] != null && #root.event['tagName'] != null
   

5. Ubah prioritas menjadi 1950.

6. Klik Create.

   

Jenis

Bagian ini memberikan ringkasan jenis yang tersedia di MDE.

Penting: Saat membuat jenis, pastikan Anda menunggu hingga jenis tersebut disediakan dan diaktifkan sepenuhnya sebelum membuat parser. Proses ini dapat memerlukan waktu hingga 2-3 menit.

Jenis untuk numeric

Berikut adalah contoh jenis basic-numeric:

REST

POST /configuration/v1/types

{
   "archetype": "NUMERIC_DATA_SERIES",
   "name": "basic-numeric"
}

Antarmuka web

Nama: basic-numeric

1. Di antarmuka web MDE, klik Types.
2. Klik Tambahkan Jenis baru.
3. Isi Type name sebagai basic-numeric.

4. Pilih NUMERIC_DATA_SERIES di drop-down untuk Archetype:

   

5. Buka bagian Setelan Penyimpanan.

6. Aktifkan atau nonaktifkan opsi Kirim ke BigQuery.

7. Klik Create.

Jenis untuk discrete

Berikut adalah contoh jenis basic-discrete:

REST

POST /configuration/v1/types

{
   "archetype": "DISCRETE_DATA_SERIES",
   "name": "basic-discrete"
}

Antarmuka web

Nama: basic-discrete

1. Di antarmuka web MDE, klik Types.
2. Klik Tambahkan Jenis baru.
3. Isi Type name sebagai basic-discrete.

4. Pilih `DISCRETE_DATA_SERIES di drop-down untuk Archetype:

   

5. Buka bagian Setelan Penyimpanan.

6. Aktifkan atau nonaktifkan opsi Kirim ke BigQuery.

7. Klik Create.

Jenis untuk continuous

Berikut adalah contoh jenis basic-continuous:

REST

POST /configuration/v1/types

{
   "archetype": "CONTINUOUS_DATA_SERIES",
   "name": "basic-continuous"
}

Antarmuka web

Nama: basic-continuous

1. Di antarmuka web MDE, klik Types.
2. Klik Tambahkan Jenis baru.
3. Isi Type name sebagai basic-continuous.

4. Pilih `CONTINUOUS_DATA_SERIES di drop-down untuk Archetype:

   

5. Buka bagian Setelan Penyimpanan.

6. Aktifkan atau nonaktifkan opsi Kirim ke BigQuery.

7. Klik Create.

Parser

Bagian ini memberikan ringkasan berbagai parser yang tersedia di MDE. Pastikan jenisnya telah sepenuhnya disediakan dan active sebelum membuat parser. Proses ini dapat memerlukan waktu hingga tiga menit.

Penting: Mulai rilis MDE 1.4.1, header pesan kini disimpan dalam atribut khusus yang disebut mdeHeaders. Jika pesan input Anda berisi atribut tersebut, ekspresi seperti embeddedMetadata: $root[where ($.field !=...)] akan menggantikan atribut yang dicadangkan dan mengakibatkan hilangnya data header yang diberikan dengan pesan edge. Pastikan Anda menggunakan ekspresi filter Whistle generik dengan hati-hati agar tidak menyebabkan kehilangan data.

Parser untuk numeric

Berikut adalah contoh parser basic-numeric:

REST

POST /configuration/v1/parsers

{
   "name": "basic-numeric-to-basic-numeric",
   "messageClassName": "basic-numeric",
   "typeReference": {
         "name": "basic-numeric",
         "version": 1
   },
   "script": "package mde\n\n[{\ntagName: $root.tagName;\ntimestamps: MapTimestamp($root);\ndata: MapData($root);\nembeddedMetadata: $root[where ($.field != \"value\" and $.field != \"tagName\" and $.field != \"timestamp\" and $.field != \"messageId\")];\n}]\n\ndef MapTimestamp(input) {\n    eventTimestamp: input.timestamp;\n}\n\ndef MapData(input) {\n    numeric: input.value;\n}"
}

Antarmuka web

Nama: basic-numeric-to-basic-numeric

1. Di antarmuka web MDE, klik Parser.
2. Klik Tambahkan Parser baru.
3. Isi Parser name sebagai basic-numeric-to-basic-numeric.
4. Pilih basic-numeric di drop-down untuk Message Class Name.

5. Salin dan tempel kode Whistle berikut di kotak Parser:

    package mde
   
    [{
    tagName: $root.tagName;
    timestamps: MapTimestamp($root);
    data: MapData($root);
    embeddedMetadata: $root[where ($.field != "value" and $.field != "tagName" and $.field != "timestamp" and $.field != "messageId")];
    }]
   
    def MapTimestamp(input) {
       eventTimestamp: input.timestamp;
    }
   
    def MapData(input) {
       numeric: input.value;
    }
   

6. Pilih basic-numeric | version: 1 di drop-down untuk Type.

7. Klik Create.

   

Parser untuk discrete

Berikut adalah contoh parser basic-discrete:

REST

POST /configuration/v1/parsers

{
   "name": "basic-discrete-to-basic-discrete",
   "messageClassName": "basic-discrete",
   "typeReference": {
         "name": "basic-discrete",
         "version": 1
   },
   "script": "package mde\n\n[{\ntagName: $root.tagName;\ntimestamps: MapTimestamp($root);\ndata: MapData($root);\nembeddedMetadata: $root[where ($.field != \"value\" and $.field != \"tagName\" and $.field != \"timestamp\" and $.field != \"messageId\")];\n}]\n\ndef MapTimestamp(input) {\n    eventTimestamp: input.timestamp;\n}\n\ndef MapData(input) {\n    complex: input.value;\n}\n"
}

Antarmuka web

Nama: basic-discrete-to-basic-discrete

1. Di antarmuka web MDE, klik Parser.
2. Klik Tambahkan Parser baru.
3. Isi Parser name sebagai basic-numeric-to-basic-discrete.
4. Pilih basic-discrete di drop-down untuk Message Class Name.

5. Salin dan tempel kode Whistle berikut di kotak Parser:

    package mde
   
    [{
    tagName: $root.tagName;
    timestamps: MapTimestamp($root);
    data: MapData($root);
    embeddedMetadata: $root[where ($.field != "value" and $.field != "tagName" and $.field != "timestamp" and $.field != "messageId")];
    }]
   
    def MapTimestamp(input) {
       eventTimestamp: input.timestamp;
    }
   
    def MapData(input) {
       complex: input.value;
    }
   

6. Pilih basic-discrete | version: 1 di drop-down untuk Type.

7. Klik Create.

   

Parser untuk continuous

Berikut adalah contoh parser basic-continuous:

REST

POST /configuration/v1/parsers

{
   "name": "basic-continuous-to-basic-continuous",
   "messageClassName": "basic-continuous",
   "typeReference": {
         "name": "basic-continuous",
         "version": 1
   },
   "script": "package mde\n\n[{\ntagName: $root.tagName;\ntimestamps: MapTimestamp($root);\ndata: MapData($root);\nduration: $root.duration;\nembeddedMetadata: $root[where ($.field != \"value\" and $.field != \"tagName\" and $.field != \"startTimestamp\" and $.field != \"endTimestamp\" and $.field != \"messageId\")];\n}]\n\ndef MapTimestamp(input) {\n    continuousTimestamp: {\n        eventTimestampStart: input.startTimestamp;\n        eventTimestampEnd: input.endTimestamp;\n    };\n}\n\ndef MapData(input) {\n    complex: input.value;\n}\n"
}

Antarmuka web

Nama: basic-continuous-to-basic-continuous

1. Di antarmuka web MDE, klik Parser.
2. Klik Tambahkan Parser baru.
3. Isi Parser name sebagai basic-numeric-to-basic-continuous.
4. Pilih basic-continuous di drop-down untuk Message Class Name.

5. Salin dan tempel kode Whistle berikut di kotak Parser:

    package mde
   
    [{
    tagName: $root.tagName;
    timestamps: MapTimestamp($root);
    data: MapData($root);
    duration: $root.duration;
    embeddedMetadata: $root[where ($.field != "value" and $.field != "tagName" and $.field != "startTimestamp" and $.field != "endTimestamp" and $.field != "messageId")];
    }]
   
    def MapTimestamp(input) {
       continuousTimestamp: {
          eventTimestampStart: input.startTimestamp;
          eventTimestampEnd: input.endTimestamp;
       };
    }
   
    def MapData(input) {
       complex: input.value;
    }
   

6. Pilih basic-continuous | version: 1 di drop-down untuk Type.

7. Klik Create.