Skip to content

Integrasi Mesin & Peralatan

Masukkan data PLC, SCADA, CNC, dan sensor ke OpexMX melalui edge connector OpexFlow, vibration edge, atau gateway Anda sendiri, lalu petakan ke parameter aset.

Diperbarui

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

Halaman integrasi yang menampilkan daftar konektor tersedia seperti webhooks, SAP, Epicor, dan integrasi MCP.

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

JalurGunakan saatYang dikirim
Edge connector OpexFlowAnda perlu membaca PLC, SCADA, CNC, atau sensor di jaringan pabrikBatch pembacaan ke endpoint telemetri
Vibration edgeAnda memantau bearing, gearbox, pompa, dan kipas dengan sensor getaranProbabilitas kerusakan dan spektrum FFT per jendela pengukuran
Gateway atau historian Anda sendiriData sudah Anda kumpulkan (Node-RED, ekspor historian, skrip SCADA)Batch pembacaan ke endpoint telemetri, dengan format yang sama
Input manualData berasal dari ronda operatorNilai 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:

  1. Aset sudah ada beserta kodenya (misalnya CMP-02 untuk kompresor) di Manajemen Aset
  2. 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
  3. 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 sumberUntuk
opex-flow edgeEdge connector OpexFlow
Vibration edgePerangkat vibration edge
API key (generic)Gateway atau skrip Anda sendiri
ManualCatatan 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:

  1. ID parameter aset yang disebut langsung di pembacaan
  2. Pemetaan tag pada konektor
  3. ID aset ditambah nama parameter
  4. 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, dan unitHint (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:

KolomArtinya
Status / Last seenApakah konektor masih mengirim
Readings/hrJumlah data per jam
QueueBerapa batch yang masih menunggu dikirim di sisi edge
Clock offsetSelisih jam edge dengan OpexMX (jam yang salah menempatkan data di waktu yang salah)
Accepted today / RejectedData yang disimpan dan ditolak hari ini
Data qualityPorsi 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.

SumberMembaca dari
Modbus TCP dan RTUPLC, VFD, energy meter, sensor
OPC-UASCADA, Siemens, Allen-Bradley, dan server OPC-UA lain, secara polling atau subscribe
EtherNet/IPController Rockwell / Allen-Bradley
MQTTSensor IoT dan perangkat lain yang mengirim ke broker
MTConnectCNC dengan agent MTConnect (Fanuc, Haas, Siemens)
Fanuc FOCASCNC 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" }
  ]
}
FieldCatatan
sequenceNomor 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
timestampISO 8601 dengan offset zona waktu; disimpan dalam UTC
backfilltrue mengirim data historis ke landing zone data pelatihan, bukan ke tabel live, sehingga tidak memicu peringatan maupun ticket rule
metadata.sentAtJam 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

BatasBawaan
Batch per konektor60 per menit (HTTP 429 jika lebih)
Pembacaan per batch5.000
Pembacaan per konektor per hari10 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

IzinMengizinkan
connector.readMelihat konektor, kesehatan, dan throughput-nya
connector.createMendaftarkan konektor dan membuat API key-nya
connector.updateMengganti nama konektor atau menyalakan dan mematikannya
connector.deleteMenonaktifkan konektor beserta key-nya
connector.mapping.readMelihat pemetaan tag dan observed tags
connector.mapping.create / update / deleteMenambah, mengimpor, mengubah, dan menghapus pemetaan tag
predictive.iot.ingestDibutuhkan pemilik key agar data diterima
parameter.read / create / update / deleteMengelola 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

  1. Pilih satu mesin yang datanya sudah Anda percaya, misalnya kompresor dengan PLC
  2. Definisikan parameter dan satuannya di Manajemen Parameter dan tautkan ke aset
  3. Daftarkan konektor dan salin key-nya
  4. Konfigurasikan OpexFlow (atau gateway Anda) dengan key dan endpoint tersebut, dan beri nama perangkat sesuai kode aset
  5. Periksa Observed tags setelah beberapa menit dan petakan tag yang belum terpetakan
  6. 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 backfill untuk 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