Lihat langsung di produk
Cara data mesin masuk ke OpexMX: parameter dan satuan per aset, konektor telemetri yang didaftarkan dengan API key dan endpoint ingest sendiri, serta kesehatan konektor di daftar.
Lokasi fitur: Manajemen → API & Integrasi → Konektor Telemetri (grup Admin) untuk mendaftarkan konektor dan memetakan tag. Parameter dan satuan ada di Manajemen → Manajemen Parameter (grup Aset).

Pernah mengalami situasi seperti ini?
- "PLC sudah tahu motornya panas. Tim maintenance baru tahu setelah motornya trip."
- "Ada orang yang keliling line dua kali per shift hanya untuk mencatat tekanan di clipboard."
- "Historian kami penuh data, tapi tidak ada orang maintenance yang bisa melihatnya."
OpexMX menerima data dari mesin Anda dan menyimpannya pada parameter aset yang tepat, tempat data itu menggerakkan skor kesehatan, peringatan, prakiraan tren, ticket rule, dan dasbor. Data masuk melalui konektor telemetri yang terdaftar: edge connector OpexFlow di lantai produksi, vibration edge di mesin berputar, atau gateway yang sudah Anda jalankan. Setiap konektor punya API key, pemetaan tag, dan angka kesehatannya sendiri, sehingga Anda langsung tahu line mana yang berhenti mengirim data.
Cara Menghubungkan
| Jalur | Gunakan saat | Yang dikirim |
|---|---|---|
| Edge connector OpexFlow | Anda perlu membaca PLC, SCADA, CNC, atau sensor di jaringan pabrik | Batch pembacaan ke endpoint telemetri |
| Vibration edge | Anda memantau bearing, gearbox, pompa, dan kipas dengan sensor getaran | Probabilitas kerusakan dan spektrum FFT per jendela pengukuran |
| Gateway atau historian Anda sendiri | Data sudah Anda kumpulkan (Node-RED, ekspor historian, skrip SCADA) | Batch pembacaan ke endpoint telemetri, dengan format yang sama |
| Input manual | Data berasal dari ronda operator | Nilai yang diketik di web atau aplikasi Field |
Konektor selalu mengirim keluar ke OpexMX melalui HTTPS. Tidak ada perangkat di pabrik Anda yang perlu menerima koneksi masuk.
Sebelum Mulai
Data disimpan pada parameter aset, dan OpexMX tidak pernah membuat parameter dari data yang masuk: pembacaan untuk tag yang tidak cocok dengan parameter mana pun ditolak dan dicatat, bukan ditebak. Jadi, siapkan dulu:
- Aset sudah ada beserta kodenya (misalnya
CMP-02untuk kompresor) di Manajemen Aset - Satuan dan parameter sudah didefinisikan di Manajemen Parameter: tab Satuan Parameter (misalnya °C, bar, mm/s), Parameter (suhu bearing, tekanan discharge), dan Parameter Aset, yang menautkan parameter ke aset
- Batas sudah diatur untuk parameter penting, sebagai aturan parameter di ticket rules pada Sistem Tiket
Langkah 1: Daftarkan Konektor
Di Konektor Telemetri, klik Register Connector, beri nama (misalnya "Edge line packing"), lalu pilih jenis sumber:
| Jenis sumber | Untuk |
|---|---|
| opex-flow edge | Edge connector OpexFlow |
| Vibration edge | Perangkat vibration edge |
| API key (generic) | Gateway atau skrip Anda sendiri |
| Manual | Catatan konektor tanpa pengiriman otomatis |
OpexMX membuat API key untuk konektor tersebut dan menampilkan ingest endpoint (https://<opexmx-anda>/api/rpc/telemetry/batch). Salin key-nya saat itu juga, karena hanya ditampilkan sekali. Key ini dimasukkan ke konfigurasi konektor sebagai header Authorization: Bearer.
Orang yang mendaftarkan konektor menjadi pemilik key-nya, dan perannya harus memiliki predictive.iot.ingest. Seed from registries membuat catatan konektor untuk sensor getaran dan API key yang sudah ada.
Langkah 2: Petakan Tag ke Parameter
Setiap pembacaan menyebut aset serta nama parameter atau tag-nya. OpexMX mencocokkannya dengan urutan berikut:
- ID parameter aset yang disebut langsung di pembacaan
- Pemetaan tag pada konektor
- ID aset ditambah nama parameter
- Kode aset ditambah nama parameter
Jika nama tag di PLC sudah sama dengan nama parameter Anda, langkah 3 dan 4 sudah cukup. Untuk tag bergaya historian (L2.CMP02.TT101.PV), tambahkan pemetaan tag:
- Map tag: satu tag → aset → parameter, dengan petunjuk satuan (opsional)
- Import tag mappings: file CSV atau XLSX dengan kolom
tag,assetCode,parameterName, danunitHint(opsional). Ekspor tag dari historian biasanya bisa langsung dipakai - Observed tags: semua tag yang pernah dikirim konektor, dengan waktu pertama dan terakhir terlihat serta jumlahnya, sehingga tag yang belum terpetakan mudah ditemukan dan dipetakan
Langkah 3: Pantau Kesehatan Konektor
Daftar konektor menampilkan untuk setiap konektor:
| Kolom | Artinya |
|---|---|
| Status / Last seen | Apakah konektor masih mengirim |
| Readings/hr | Jumlah data per jam |
| Queue | Berapa batch yang masih menunggu dikirim di sisi edge |
| Clock offset | Selisih jam edge dengan OpexMX (jam yang salah menempatkan data di waktu yang salah) |
| Accepted today / Rejected | Data yang disimpan dan ditolak hari ini |
| Data quality | Porsi data yang lengkap, basi (stale), dan berkualitas buruk |
Data yang ditolak disimpan di karantina beserta alasannya (tag tidak dikenal, satuan tidak cocok, di luar rentang, timestamp di masa depan, dan sebagainya) di Pemantauan Kondisi → Kualitas Data, tempat data itu bisa dilepas atau dibuang.
Edge Connector OpexFlow
OpexFlow adalah edge connector industri kami, dengan lisensi terpisah dari OpexMX. OpexFlow berjalan sebagai satu file biner di Raspberry Pi, PC industri, atau server, membaca peralatan Anda, menyimpan salinan lokal, lalu mengirimkannya ke OpexMX.
| Sumber | Membaca dari |
|---|---|
| Modbus TCP dan RTU | PLC, VFD, energy meter, sensor |
| OPC-UA | SCADA, Siemens, Allen-Bradley, dan server OPC-UA lain, secara polling atau subscribe |
| EtherNet/IP | Controller Rockwell / Allen-Bradley |
| MQTT | Sensor IoT dan perangkat lain yang mengirim ke broker |
| MTConnect | CNC dengan agent MTConnect (Fanuc, Haas, Siemens) |
| Fanuc FOCAS | CNC Fanuc: status jalan, posisi sumbu, kecepatan spindle, alarm |
OpexFlow menyimpan data di SQLite lokal (bawaan 7 hari), mengirim ulang lewat antrean yang tahan restart saat jaringan putus, dan punya editor flow serta tampilan live berbasis browser di perangkat edge. Referensi lengkap: dokumentasi OpexFlow.
Untuk mengirim ke OpexMX, gunakan format batch opexmx dengan key dan endpoint dari Langkah 1:
connector:
name: packing-line-edge
push_queue:
enabled: true # wajib untuk batching
batch:
enabled: true
format: opexmx
endpoint: https://<opexmx-anda>/api/rpc/telemetry/batch
api_token: ${OPEXMX_CONNECTOR_KEY}
max_records: 100
flush_interval_secs: 5
OpexFlow memakai id setiap perangkat sebagai kode aset, jadi beri nama perangkat sesuai kode aset di OpexMX (atau petakan tag-nya di Langkah 2).
Vibration Edge
Vibration edge berjalan di komputer kecil di dekat mesin, menganalisis setiap jendela pengukuran, dan mengirim hasilnya ke OpexMX: probabilitas kerusakan dari model getaran dan, pada mode FFT, spektrumnya. Daftarkan sensor di Pemantauan Kondisi → Pemantauan Getaran beserta aset yang dipantaunya. Pendaftaran mengembalikan API key sensor satu kali; key itu terikat ke satu sensor tersebut, dan setiap key boleh mengirim paling banyak 120 request per menit.
OpexMX mengklasifikasikan level getaran berdasarkan zona ISO 20816, menandai frekuensi kerusakan, memunculkan peringatan setelah sejumlah jendela kerusakan berturut-turut (bawaan 3), dan bisa membuka tiket secara otomatis. Lihat Pemantauan Kondisi. Untuk menambahkan jaminan pengiriman dan penyaringan data antara edge dan OpexMX, pasang OpexFlow di tengahnya (panduan).
Gateway Anda Sendiri: API Telemetri
Sistem apa pun yang bisa melakukan request HTTPS bisa mengirim data. Daftarkan konektor dengan jenis sumber API key (generic), lalu:
POST /api/rpc/telemetry/batch
Authorization: Bearer mx_...
Content-Type: application/json
{
"sequence": 1842,
"metadata": { "sentAt": "2026-03-04T07:24:20+07:00" },
"readings": [
{ "assetCode": "CMP-02", "parameter": "discharge_temperature", "value": 96.4, "unit": "°C", "timestamp": "2026-03-04T07:24:15+07:00" },
{ "assetCode": "CMP-02", "parameter": "discharge_pressure", "value": 7.8, "unit": "bar", "timestamp": "2026-03-04T07:24:15+07:00" }
]
}
| Field | Catatan |
|---|---|
sequence | Nomor yang terus naik per konektor. Batch dengan sequence yang sudah pernah diterima dianggap duplikat dan tidak disimpan dua kali, jadi pengiriman ulang aman |
readings[] | Maksimal 5.000 per batch. Setiap pembacaan butuh parameter, value, timestamp, dan salah satu dari assetCode, assetId, atau assetParameterId. unit dan quality opsional |
timestamp | ISO 8601 dengan offset zona waktu; disimpan dalam UTC |
backfill | true mengirim data historis ke landing zone data pelatihan, bukan ke tabel live, sehingga tidak memicu peringatan maupun ticket rule |
metadata.sentAt | Jam pengirim saat mengirim; dipakai untuk mengukur clock offset |
Respons menyebutkan berapa pembacaan yang disimpan dan ditolak, beserta alasan setiap penolakan (maksimal 100 yang dicantumkan), serta clock offset yang terukur.
Batasan
| Batas | Bawaan |
|---|---|
| Batch per konektor | 60 per menit (HTTP 429 jika lebih) |
| Pembacaan per batch | 5.000 |
| Pembacaan per konektor per hari | 10 juta |
Batch live langsung dicek terhadap ticket rule saat masuk, dan skor kesehatan aset diperbarui dalam beberapa menit.
Keamanan
- Setiap konektor punya API key sendiri; menonaktifkan konektor juga menonaktifkan key-nya
- Key dicek terhadap tenant, sehingga key dari satu workspace OpexMX tidak bisa menulis ke workspace lain
- Koneksi hanya keluar, dari jaringan Anda ke OpexMX melalui HTTPS
- Setiap pembacaan disaring sebelum disimpan, dan yang ditolak disimpan untuk ditinjau, bukan dibuang
Siapa Bisa Melakukan Apa
| Izin | Mengizinkan |
|---|---|
connector.read | Melihat konektor, kesehatan, dan throughput-nya |
connector.create | Mendaftarkan konektor dan membuat API key-nya |
connector.update | Mengganti nama konektor atau menyalakan dan mematikannya |
connector.delete | Menonaktifkan konektor beserta key-nya |
connector.mapping.read | Melihat pemetaan tag dan observed tags |
connector.mapping.create / update / delete | Menambah, mengimpor, mengubah, dan menghapus pemetaan tag |
predictive.iot.ingest | Dibutuhkan pemilik key agar data diterima |
parameter.read / create / update / delete | Mengelola parameter di Manajemen Parameter |
Secara bawaan, Admin memiliki semuanya. Supervisor juga bisa melihat konektor dan pemetaan tag. Supervisor dan Engineer memiliki predictive.iot.ingest, sehingga bisa menjadi pemilik key konektor, serta bisa membuat dan mengubah parameter. Atur peran di Manajemen Pengguna.
Langkah Awal
- Pilih satu mesin yang datanya sudah Anda percaya, misalnya kompresor dengan PLC
- Definisikan parameter dan satuannya di Manajemen Parameter dan tautkan ke aset
- Daftarkan konektor dan salin key-nya
- Konfigurasikan OpexFlow (atau gateway Anda) dengan key dan endpoint tersebut, dan beri nama perangkat sesuai kode aset
- Periksa Observed tags setelah beberapa menit dan petakan tag yang belum terpetakan
- Atur batas pada satu parameter sebagai ticket rule dan pantau trennya di Pemantauan Kondisi
Tips
- Sinkronkan jam perangkat edge dengan NTP: kolom clock offset menunjukkan pergeseran jam sebelum tren Anda jadi melenceng
- Kirim satuan bersama data; satuan yang tidak cocok dikarantina, bukan disimpan sebagai angka yang salah
- Gunakan
backfilluntuk memuat ekspor historian sebagai data pelatihan model tanpa membanjiri kotak masuk peringatan - Mulailah dengan beberapa parameter per mesin (suhu, getaran, arus), bukan semua tag yang tersedia di PLC
Terkait
- Pemantauan Kondisi: apa yang dilakukan OpexMX dengan data tersebut
- Sistem Tiket: aturan parameter yang membuka tiket
- Manajemen Aset: kode aset dan parameter
- API & Integrasi: API key, webhook, dan referensi API
- OpexMX dengan SAP melalui OpexFlow: OpexFlow di sisi bisnis