How to Configure Data Logging
Set up data logging to capture CAN bus data to files, InfluxDB, Prometheus, or MQTT.
Prerequisites
- An active profile with components configured
- (For cloud logging) Access to InfluxDB, Prometheus, or MQTT server
- Admin access to configure loggers
Steps
Step 1: Choose Your Logger Type
Profinity supports: - File Logger - Log to CSV or other file formats - InfluxDB/Prometheus Logger - Log to time-series databases - MQTT Logger - Publish data to MQTT brokers
Step 2: Add a Logger Component
- Navigate to ADMIN → Components
- Click Add Component
- Select your logger type:
- File Logger
- InfluxDB Prometheus Logger
- MQTT Logger
Step 3: Configure File Logger
- Set Logger Name
- Configure File Path - where log files are saved
- Set File Format - CSV, JSON, etc.
- Configure Logging Interval - how often to write data
- Select Components - choose which components to log
- Click Save
Step 4: Configure InfluxDB/Prometheus Logger
- Set Logger Name
- Configure connection:
- InfluxDB URL - server address
- Database Name - target database
- Username/Password - credentials
- Set Logging Interval
- Select Components
- Test Connection
- Click Save
Step 5: Configure MQTT Logger
- Set Logger Name
- Configure MQTT Broker:
- Broker URL - MQTT broker address
- Port - usually 1883 or 8883
- Username/Password - if required
- Topic Prefix - base topic for messages
- Set Publishing Interval
- Select Components
- Test Connection
- Click Save
Step 6: Activate the Logger
- Ensure logger is added to your active profile
- Logger starts automatically when profile is active
- Check logger status in component list
Step 7: Verify Logging
File Logging: - Check file path for new log files - Verify data is being written
InfluxDB/Prometheus: - Query database to verify data is arriving - Check connection status in logger component
MQTT: - Subscribe to MQTT topics to see published messages - Check logger status for connection info
Tips
- Start with File Logging: Easiest to set up and verify
- Monitor Disk Space: File loggers can generate large files
- Use Appropriate Intervals: Balance between data granularity and resource usage
- Test Connections: Always test cloud loggers before relying on them
- Filter Components: Only log components you need to reduce data volume
Troubleshooting
- No data being logged: Check that components are selected and active
- Connection errors: Verify network connectivity and credentials
- Missing data: Check logging intervals and component data availability
Related Documentation
- File Loggers - Detailed file logger configuration
- InfluxDB Prometheus Logger - Cloud logging setup
- MQTT Logger - MQTT publishing configuration