> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mertani.co.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Status Device

Status device menunjukkan kondisi konektivitas dan operasional perangkat secara realtime. Sistem akan memperbarui status ini secara otomatis berdasarkan aktivitas pengiriman data, kecuali status `maintenance` yang diatur secara manual oleh administrator atau teknisi.

***

## Jenis Status Device

| Status                                                                                                                                                         | Arti                                                                                                               |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| <span style={{ backgroundColor: 'rgba(18, 183, 106, 0.24)', color: '#12b76a', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>online</span>      | Perangkat aktif dan mengirim data sesuai jadwal yang ditentukan.                                                   |
| <span style={{ backgroundColor: 'rgba(255, 193, 7, 0.24)', color: '#ffc107', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>delay</span>        | Perangkat masih aktif, tetapi data terlambat masuk, selisih waktu melebihi 3× interval pengiriman normal.          |
| <span style={{ backgroundColor: 'rgba(239, 76, 73, 0.24)', color: '#ef4c49', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>offline</span>      | Perangkat tidak mengirim data selama ≥ 24 jam. Kemungkinan mati, kehilangan daya, atau tidak ada koneksi jaringan. |
| <span style={{ backgroundColor: 'rgba(229, 231, 235, 0.7)', color: '#4B5563', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>maintenance</span> | Perangkat sedang dalam proses perbaikan atau pengecekan oleh teknisi. Status ini diatur secara manual.             |

***

## Bagaimana Status Ditentukan?

Sistem menentukan status berdasarkan urutan prioritas berikut:

<Steps>
  <Step title="Cek status maintenance">
    Jika perangkat sedang ditandai <span style={{ backgroundColor: 'rgba(229, 231, 235, 0.7)', color: '#4B5563', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>maintenance</span> oleh admin, status tetap **maintenance**, meskipun perangkat tidak mengirim data.
  </Step>

  <Step title="Cek apakah data berhenti total">
    Jika tidak ada data masuk selama **≥ 24 jam**, status berubah menjadi <span style={{ backgroundColor: 'rgba(239, 76, 73, 0.24)', color: '#ef4c49', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>offline</span>.
  </Step>

  <Step title="Cek keterlambatan pengiriman">
    Jika data masih masuk tetapi terlambat (selisih waktu > 3× interval normal), status menjadi <span style={{ backgroundColor: 'rgba(255, 193, 7, 0.24)', color: '#ffc107', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>delay</span>.
  </Step>

  <Step title="Status normal">
    Jika tidak ada kondisi di atas, perangkat dianggap <span style={{ backgroundColor: 'rgba(18, 183, 106, 0.24)', color: '#12b76a', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>online</span>.
  </Step>
</Steps>

***

## Detail Setiap Status

<AccordionGroup>
  <Accordion title="🟢 Online">
    Perangkat dianggap **online** apabila data terakhir diterima masih dalam batas interval normal.

    <Card title="Contoh">
      **Interval pengiriman device:** `10 menit`

      | `Waktu` | `Data Diterima?` |
      | ------- | ---------------- |
      | 09:00   | ✅                |
      | 09:10   | ✅                |
      | 09:20   | ✅                |

      → Status: <span style={{ backgroundColor: 'rgba(18, 183, 106, 0.24)', color: '#12b76a', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>online</span>
    </Card>
  </Accordion>

  <Accordion title="🟡 Delay">
    Perangkat dianggap **delay** apabila data masih diterima, tetapi terlambat dari jadwal normal.

    **Rumus penentuan delay:**

    ```txt theme={null}
    selisih waktu data terakhir  >  3 × interval pengiriman
    ```

    <Card title="Contoh">
      **Interval pengiriman device:** `5 menit`

      **Batas toleransi sebelum delay:** `3 × 5 menit = 15 menit`

      | `Kondisi`              | `Nilai`  |
      | ---------------------- | -------- |
      | Data terakhir diterima | 10:00    |
      | Waktu sekarang         | 10:20    |
      | Selisih                | 20 menit |

      Karena 20 menit > 15 menit, maka status berubah menjadi <span style={{ backgroundColor: 'rgba(255, 193, 7, 0.24)', color: '#ffc107', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>delay</span>
    </Card>
  </Accordion>

  <Accordion title="🔴 Offline">
    Perangkat dianggap **offline** apabila tidak ada data yang masuk selama ≥ 24 jam.

    **Penyebab umum:**

    * Perangkat mati atau kehabisan daya
    * Tidak ada sinyal jaringan (GSM/internet)
    * SIM card atau modem bermasalah
    * Kerusakan pada perangkat

    <Card title="Contoh">
      | `Kondisi`              | `Nilai`            |
      | ---------------------- | ------------------ |
      | Data terakhir diterima | 10 Mei 2026, 08:00 |
      | Waktu sekarang         | 11 Mei 2026, 09:00 |
      | Selisih                | 25 jam             |

      Karena sudah lebih dari 24 jam tanpa data, status berubah menjadi <span style={{ backgroundColor: 'rgba(239, 76, 73, 0.24)', color: '#ef4c49', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>offline</span>
    </Card>

    <Warning>
      Perangkat yang sudah offline lebih dari beberapa hari disarankan segera dicek langsung di lapangan.
    </Warning>
  </Accordion>

  <Accordion title="⚪ Maintenance">
    Status **maintenance** digunakan saat perangkat sedang ditangani secara fisik oleh teknisi, misalnya:

    * Perbaikan atau penggantian komponen
    * Kalibrasi sensor
    * Pengecekan rutin di lapangan

    **Karakteristik:**

    * Status diatur secara manual oleh admin atau operator
    * Perangkat dengan status ini dapat dikecualikan dari notifikasi alarm

    <Card title="Contoh">
      Teknisi lapangan sedang mengganti sensor di perangkat Y789.
      Admin mengubah status menjadi <span style={{ backgroundColor: 'rgba(229, 231, 235, 0.7)', color: '#4B5563', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>maintenance</span> agar sistem tidak mengirimkan alert selama proses berlangsung.
    </Card>

    <Note>
      Jangan lupa kembalikan status ke kondisi semula setelah maintenance selesai agar monitoring kembali berjalan normal.
    </Note>
  </Accordion>
</AccordionGroup>

***

## Menyaring Device Berdasarkan Status

Gunakan fitur filter untuk menampilkan perangkat berdasarkan status tertentu. Filter tersedia di dua tampilan: **Map View** dan **Manajemen Device**.

<Tabs>
  <Tab title="Map View">
    <Steps>
      <Step title="Buka menu Layer">
        Klik ikon **Layer** di pojok peta untuk membuka panel pengaturan tampilan.
      </Step>

      <Step title="Pilih Status Perangkat">
        Di dalam panel Layer, klik **Status Perangkat** untuk melihat opsi filter status.
      </Step>

      <Step title="Pilih status yang ingin ditampilkan">
        Centang atau hapus centang status yang diinginkan:

        * <span style={{ backgroundColor: 'rgba(18, 183, 106, 0.24)', color: '#12b76a', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>online</span>
        * <span style={{ backgroundColor: 'rgba(255, 193, 7, 0.24)', color: '#ffc107', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>delay</span>
        * <span style={{ backgroundColor: 'rgba(239, 76, 73, 0.24)', color: '#ef4c49', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>offline</span>
        * <span style={{ backgroundColor: 'rgba(229, 231, 235, 0.7)', color: '#4B5563', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>maintenance</span>

        Penanda perangkat di peta akan otomatis diperbarui sesuai pilihan.

        <Frame>
          <div>
            <video title="Video status filter" src="https://mintcdn.com/mertani/AZ18z9avX2hzycsv/assets/dashboard-guides/monitoring/filter-status-maps.mp4?fit=max&auto=format&n=AZ18z9avX2hzycsv&q=85&s=62e1a59085ccd45aab79e3761d69266e" autoPlay loop playsInline muted data-path="assets/dashboard-guides/monitoring/filter-status-maps.mp4" />
          </div>
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Manajemen Device">
    <Steps>
      <Step title="Buka halaman Manajemen Device">
        Masuk ke menu **Manajemen Device**. Secara default, semua perangkat dengan semua status akan ditampilkan.
      </Step>

      <Step title="Gunakan filter status">
        Klik salah satu tombol filter di bagian atas daftar:

        | Filter                                                                                                                                                         | Perangkat yang ditampilkan             |
        | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
        | `Semua Status`                                                                                                                                                 | Semua perangkat tanpa terkecuali       |
        | <span style={{ backgroundColor: 'rgba(21, 168, 60, 0.24)', color: '#15803D', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>online</span>       | Perangkat yang aktif mengirim data     |
        | <span style={{ backgroundColor: 'rgba(241, 194, 50, 0.24)', color: '#A16207', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>delay</span>       | Perangkat yang terlambat mengirim data |
        | <span style={{ backgroundColor: 'rgba(185, 28, 28, 0.24)', color: '#B91C1C', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>offline</span>      | Perangkat yang tidak aktif ≥ 24 jam    |
        | <span style={{ backgroundColor: 'rgba(229, 231, 235, 0.7)', color: '#4B5563', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>maintenance</span> | Perangkat yang sedang dalam perawatan  |

        <Frame>
          <div>
            <video src="https://mintcdn.com/mertani/AZ18z9avX2hzycsv/assets/dashboard-guides/monitoring/filter-status-managedevice.mp4?fit=max&auto=format&n=AZ18z9avX2hzycsv&q=85&s=1ff92c93868cbbf5f5c02dcdad0c9252" autoPlay loop playsInline muted data-path="assets/dashboard-guides/monitoring/filter-status-managedevice.mp4" />
          </div>
        </Frame>
      </Step>
    </Steps>
  </Tab>
</Tabs>