Skip to main content

Processing Log

The Processing Log is a chronological list of logs emitted while Memfault processes the data received from a Project's Devices. It is useful when troubleshooting an integration, for example finding uploads that were received but could not be processed. See the Processing Log page for more on the feature.

Entries are retained for 60 days, and a single request can span at most 60 days.

Pagination​

This API does not use the page and per_page parameters described in the introduction. Requests that include them are rejected. Instead, it uses cursor-based pagination:

  1. Make a request with start and any other filters. Use page[size] to set the number of entries per response (default: 100, max: 500).
  2. If the response has a non-null links.next, request that URL, relative to https://api.memfault.com, to get the next page.
  3. Repeat until links.next is null. links.next is only null when a response contains no entries, so the final response has an empty data list.

links.next is the current request with page[after] and end filled in. page[after] is the created_date of the last entry returned, and end is pinned to its resolved value, so entries that arrive while you are paging do not shift the pages. Do not construct page[after] by hand, and do not change other filters between requests.

curl -g --user user@example.com:$API_KEY \
"https://api.memfault.com/api/v0/organizations/acme/projects/widget/processing-log?start=2026-10-01T00:00:00Z&level=error&page[size]=200"
{
"data": [
{
"created_date": "2026-10-01T12:03:41.512093+00:00",
"device_serial": "ABCD1234",
"software_version": "1.2.3",
"event_type": "SymbolFileMissing",
"level": "error",
"source": "coredump"
}
],
"links": {
"next": "/api/v0/organizations/acme/projects/widget/processing-log?start=2026-10-01T00:00:00Z&level=error&page%5Bsize%5D=200&end=2026-10-19T14:00:00%2B00:00&page%5Bafter%5D=2026-10-01T12:03:41.512093%2B00:00"
}
}

Processing Log Entry Schema​

FieldTypeDescription
created_dateDateTimeWhen the entry was logged
device_serialString | nullSerial of the Device the entry relates to, if any
software_versionString | nullSoftware Version reported with the data, if any
event_typeStringThe kind of entry. See Event Types
levelStringOne of error, warning, or info
sourceStringThe component that produced the entry
event_dataObject | nullEvent specific details. Only present when include_event_data=true; contents vary by event_type. Clients should be permissive when parsing event data, as it may change over time.

Event Types​

Use the event_type query parameter to filter on these values. The List Processing Log Event Types endpoint returns the subset that has been recorded for your Project. New event types may be added over time, so clients should tolerate unknown values.

Event TypeDescription
AndroidBatteryStatsHistoryParseErrorError parsing batterystats history
AndroidBatteryStatsSummaryParseErrorError parsing batterystats summary
AndroidDeviceCollectionRateLimitExceededDevice Collection Throttled
AndroidFileCleanupErrorError cleaning up files
AndroidJobErrorAndroid job failed
AndroidUnknownErrorAndroid SDK Error
BadZipFileMarFileProcessingErrorMAR upload not a valid ZIP file
BugreportParseErrorBug Report parsing error
ChunkReassemblyFailureChunk reassembly failure
CoredumpAnalyzerErrorCoredump analysis error
CoredumpAnalyzerTimeoutCoredump analysis timeout
DataDroppedDueToFleetSamplingData dropped due to Fleet Sampling
DataDroppedDueToVisibilityLevelDevice data dropped due to Visibility Level mismatch
DeviceRateLimitExceededDevice Reporting Throttled
DropBoxEntryProcessingExceptionDropBoxManager Entry processing error
DuplicateCoredumpDuplicate Coredump received
DuplicateElfCoredumpDuplicate ELF Coredump received
DuplicateLinuxStacktraceDuplicate Linux Stacktrace received
DuplicateTraceDuplicate trace received
DuplicateTraceEventDuplicate Trace Event received
HeartbeatMetricExtractionErrorHeartbeat metrics extraction error
InvalidHttpRequestErrorInvalid HTTP request
LogFormatErrorLog format error
MarFileProcessingErrorMAR processing error
OutgoingWebhookDeliveredOutgoing webhook delivered
OutgoingWebhookFailedOutgoing webhook failed
ProcessAndroidBugreportFromMarTaskFailureMAR Android Bug Report processing task failed
ProcessAndroidDropboxManagerEntryFromMarTaskFailureMAR Android DropBoxManager processing task failed
ProcessAndroidHeartbeatFromMarTaskFailureMAR Android heartbeat processing task failed
ProcessAndroidHeartbeatTaskFailureAndroid heartbeat processing task failed
ProcessAndroidHeartbeatWithBatteryStatsTaskFailureAndroid heartbeat with battery stats processing task failed
ProcessAndroidLogcatFromMarTaskFailureMAR Android logcat processing task failed
ProcessAndroidLogcatTaskFailureAndroid logcat processing task failed
ProcessAndroidRebootFromMarTaskFailureMAR Android reboot processing task failed
ProcessAndroidSELinuxFromMarTaskFailureMAR Android SELinux processing task failed
ProcessAndroidStructuredLogFromMarTaskFailureMAR Android structured log processing task failed
ProcessBugreportMainpassTaskFailureProcess Bug Report processing task failed
ProcessBugreportPrepassTaskFailureBug Report pre-processing task failed
ProcessBugreportReprocessTaskFailureBug Report re-processing task failed
ProcessCdrFromMarTaskFailureMAR custom data recording processing task failed
ProcessCoredumpAnalyzeTaskFailureMCU coredump processing task failed
ProcessCoredumpDispatchTaskFailureMCU coredump processing task failed
ProcessDeviceAttributesFromMarTaskFailureMAR device attributes processing task failed
ProcessDeviceConfigFromMarTaskFailureMAR device config processing task failed
ProcessDropboxManagerEntryTaskFailureDropBoxManager Entry processing task failed
ProcessElfCoredumpFromMarTaskFailureMAR Linux coredump processing task failed
ProcessElfCoredumpTaskFailureLinux coredump processing task failed
ProcessEmbeddedLogsTaskFailureEmbedded logs task failed
ProcessLinuxCustomTraceFromMarTaskFailureMAR Linux custom trace processing task failed
ProcessLinuxHeartbeatFromMarTaskFailureMAR Linux heartbeat processing task failed
ProcessLinuxLogsFromMarTaskFailureMAR Linux logs processing task failed
ProcessLinuxRebootFromMarTaskFailureMAR Linux reboot processing task failed
ProcessLinuxStacktraceTaskFailureLinux stacktrace processing task failed
ProcessMcuCdrTaskFailureMCU custom data recording task failed
ProcessTraceEventTaskFailureTrace Event processing task failed
ProcessXcdFileTaskFailureXCD file processing task failed
ProcessXedFileTaskFailureXED file processing task failed
PushBasedOTABatchAbortedPush-based OTA superseded by another
PushBasedOTABatchDeliveredPush-based OTA batch delivered
PushBasedOTABatchFailedPush-based OTA batch failed
PushBasedOTADeliveredPush-based OTA completed successfully
ReceivedDataBatteryStatsReceived batterystats file
ReceivedDataBugReportReceived bug report
ReceivedDataCoredumpReceived coredump
ReceivedDataCustomDataRecordingReceived custom data recording
ReceivedDataDropBoxManagerEntryReceived DropBoxManager entry
ReceivedDataElfCoredumpReceived ELF coredump
ReceivedDataHeartbeatEventReceived Metric Report
ReceivedDataLinuxStacktraceReceived Linux Stacktrace
ReceivedDataLogFileReceived log file
ReceivedDataMarFileReceived MAR file
ReceivedDataMiscEventReceived miscellaneous event
ReceivedDataNrfCloudCheckinReceived nRF Cloud check-in
ReceivedDataOtaAbortedEventReceived OTA aborted event
ReceivedDataOtaCheckForUpdateEventReceived OTA check for update event
ReceivedDataOtaDownloadingEventReceived OTA downloading event
ReceivedDataOtaFailedEventReceived OTA failed event
ReceivedDataOtaInstallingEventReceived OTA installing event
ReceivedDataOtaRebootingEventReceived OTA rebooting event
ReceivedDataOtaSuccessEventReceived OTA success event
ReceivedDataRebootEventReceived reboot event
ReceivedDataStructuredLogReceived structured log
ReceivedDataTraceEventReceived trace event
StoreBugreportTaskFailureStore Bug Report task failed
SuspiciousCapturedDateSuspicious captured date
SymbolFileMetricExtractorErrorMetric metadata extraction failed
SymbolFileMissingSymbol file missing
TraceIgnoredTrace matched an ignore rule
UploadCdrTaskFailureUpload custom data recording task failed