AFAQY Knowledge Base
    Messages
    Messages

    Messages

    πŸ“– Afaqy Knowledge Base / AVL / Messages

    CONTENTS
    β€£
    Introduction
    • About Afaqy
    • AVL Pro
    β€£
    Technical Requirements
    • Recommended Web Browsers
    • Hardware Specifications
    • Internet Connection
    β€£
    Quick Start
    • Account Setup
    • Logging In
    • Resetting Password
    • Glossary
    β€£
    Map
    • Map Navigation
    • Map Tools
    β€£
    Monitoring
    • Monitoring List
    • Monitoring Tools
    • Monitoring Fields
    β€£
    Dashboard
    β€£
    Statistics
    • Overview
    • Accessing Statistics
    • Filters & Controls
    • Units
    • Status
    • Others
    • Activity & Reporting
    • Exporting Data
    • Related Pages
    β€£
    Charts
    • Chart Types
    • Creating a chart
    • Chart Tools
    β€£
    Geofences
    • Overview
    • Purpose
    • Page Components
    • Display Modes
    • Unit Count Indicator
    • Actions
    • Best Practices
    β€£
    Reports
    • Reports Tab
    • Templates Tab
    • Schedules Tab
    β€£
    Report Categories Breakdown
    • Summary Reports
    • Vehicle Activity Reports
    • Driving Quality Reports
    • Zones Activity Reports
    • Sensors Activity Reports
    • Other Reports
    β€£
    Units
    • Selecting Columns
    • Creating a Unit
    • Creating a Sensor
    • Creating a Command
    • FAQs
    β€£
    Units Management
    • Importing Units
    • Accessing Units
    • Unit Groups
    • Unit Shared Groups
    • Exporting Units
    • Deleting Units
    • FAQ
    β€£
    Messages
    • Permissions
    • Tracing Messages
    • Table View
    • Graph View
    • Common Tools
    • Troubleshooting
    β€£
    Second By Second
    • Permissions
    • Scope & Limits
    • Tracing Second by Second
    • Table View
    • Graph View
    • When to use
    • Troubleshooting
    β€£
    Tracking
    • Tracking Fields
    • Generating a track
    • Tracking Tools
    β€£
    Multi-Unit Follow
    • Screen List
    • Maps
    β€£
    Users
    • Selecting Columns
    • Adding a user
    • Users Management
    • Roles & Permissions
    • User Activity & Auditing
    • Best Practices
    • Permissions & Visibility
    β€£
    Geofences
    • Geofences List
    • Markers List
    β€£
    Geofences Management
    • Importing Geofences
    • Accessing Geofences
    • Geofences Groups
    • Exporting Geofences
    β€£
    Customers
    • Selecting Columns
    • Adding a customer
    • Customers Management
    β€£
    Resources
    • Trailers
    • Drivers
    • Events
    • Status
    • Custom Fields
    β€£
    Settings
    • Protocols
    • Packages
    • Roles & Permissions
    β€£
    Audit Log
    • Overview
    • Purpose
    • Scope of Logged Activities
    • Page Components
    • Event Details
    • Export & Retention
    • Access Control
    • Best Practices

    The Messages section gives you a raw, timestamped stream of every update a unit sends to AVL (parameters + sensors). Use it to diagnose connectivity, validate sensor behavior, and investigate incidents at the most granular level.

    image
    1 2 3 4 5 6
    Homepage Button Select Unit Current Section Edit Unit Table Tab Graph Tab
    7 8 9 10 11 12
    User Apps Button Notifications Button Full-Screen Button Manage Account Button Sub-User(s) List Map View Button
    13 14 15 16 17 18
    Monitoring / Total Stopping Units Moving Units Updates Button Time O'clock Customize Grid Columns

    Permissions

    • Users must have view access to the selected unit(s).
    • If units are shared via Shared Groups, users with View Only / Inherit can read messages for those units.
    • Admins can query a single unit at a time, even within shared accounts, in accordance with the tenant setup permissions.

    Tracing Messages

    Follow these steps to trace messages for any unit:

    image
    1. Select Unit(s)
      • Use the Unit Search field.
      • Search by Unit Name or IMEI.
      • Only a single unit can be added at a time.
      • Units shared via Shared Groups are visible if you have view permission.
    2. Choose Source
    • Parameters: Raw device/sensor data (e.g., speed, position, voltage, ACC, RPM).
    • Sensors: Values after sensor calibration (e.g., fuel level, temperature, weight).
    • Both: merges parameters + sensors in one stream.
    πŸ’‘

    Tip: For fuel/temperature investigations, start with Sensors to declutter.

    1. Set Time Range
    • Presets: Today, Yesterday, Last Week, Last Month.
    • Or choose a Custom range (From / To).
    • The To time cannot exceed the current time.
    πŸ’‘

    The maximum interval between the From and To dates is three months

    1. Run Query
      • Click Execute to fetch messages.
      • Click Cancel to stop a long-running query.
      • Use Reset to clear all filters.
    2. Review Summary
      1. After execution, a summary strip appears below the mentioned input:

      2. Duration: span of time covered.
      3. Distance: total route length.
      4. Average Speed.
      5. Maximum Speed.
    3. Explore Results
      • Switch between Table View and Graph View using the toggle.
      • Use Export to download results to Excel.

    Table View

    The Table View lists each message as a row with full details.

    image

    Columns

    Displayed columns depend on unit profile and installed sensors. Common fields include:

    • Timestamps: Device Time, Server Time
    • Location: Latitude, Longitude, Address, Altitude
    • Movement: Speed, Motion/ACC, RPM
    • Sensors: Fuel level, Temperature(s), Weight/Axle load
    • Electrical: Main/Backup Voltage, Satellites, Accuracy

    No assignments displayed in messages table

    Graph View

    The Graph View visualizes selected parameters over time.

    image

    Controls

    • Parameter Selector β†’ choose series (Speed, Fuel, Temp, Voltage, RPM, etc.).
    • Legend Toggles β†’ show/hide series.
    • Zoom & Pan β†’ drag to zoom into a window, reset to fit all data.
    • Tooltip & Crosshair β†’ hover to see exact timestamp + value.
    • Row Sync (if enabled) β†’ click a graph point to highlight corresponding table row.

    Usage

    • Plot Fuel Level + Speed β†’ spot fuel drops while stationary.
    • Plot Temperature + Door β†’ detect cold-chain breaches.
    • Plot Speed + Satellites β†’ validate GPS accuracy.

    Common Tasks

    A) Check if a vehicle stopped sending data

    1. Source = Both β†’ Unit = target vehicle β†’ Time = Today (last 2–4h) β†’ Execute
    2. Confirm timestamp gaps in Table; verify Voltages/ACC for power issues.
    3. If there’s a gap: check SIM/connectivity/device power.

    B) Investigate a fuel‑theft claim

    1. Source = Sensors β†’ choose the unit β†’ Custom time covering the incident (≀ 6h) β†’ Execute
    2. In Graph, add Fuel Level + Speed; look for sharp drops while stationary.
    3. Cross‑check exact timestamps & values in Table; export if needed.

    C) Validate overspeed complaint

    1. Source = Parameters β†’ select unit β†’ relevant Custom range β†’ Execute
    2. In Table, sort by Speed (desc) and review Max speed in summary.
    3. Use Graph to visualize peaks; check satellites/accuracy for GPS jumps.

    Troubleshooting

    • No rows returned
      • Confirm time window and unit selection; ensure device actually transmitted.
      • If querying multiple units, test each unit separately.
    • Slow queries
      • Reduce window length, limit to a single unit.
      • Use Sensors or Parameters (not Both) when you only need one side.
    icon
    Units
    icon
    Second By Second