Skip to main content

Sending Logs

Prerequisites

Our platform provides functionality for tracking your devices logs, so you can have a better sense of things that are happening out in the field.

An endpoint is provided on our gateways on the /logs path where the device can send log data. Right now only the CoAP gateway is available to use this service.

Data can be sent using query parameters and also on the message body. The message body can be send in CBOR or JSON format and is going to be parsed and we will try to identify the known attributes as presented bellow. If the body is sent as plain text, it will be saved as the log entry message.

See CoAP Gateway Interface or MQTT Gateway Interface

Simulating device logs using coap

You can simulate sending logs by using coap and POSTing data to the /logs endpoint.

In the example bellow, we are sending the parameters module, level and network as query parameters and also a message in JSON format in the body containing the log msg.

coap --path /logs -m POST --psk-id [email protected] --psk supersecret -q module=sensor -q level=info -q network=sensor --host coap.golioth.io -b "{\"msg\":\"Hello World\"}" --format json
Response
payload: Type: Acknowledgement, MID: 64363, Code: Content, Token: 56f991b6703947d7, ContentFormat: application/json
body: "OK"

After sending a log entry you can search logs using goliothctl. Check the next page for more details on how to do that.