Skip to main content

Logs and Events

Enabling CloudLogger​

Today, logging output through Resolver.Log.Info("foo bar"); writes to the console. This is great if you are working locally, connected to the device, but not so much when the device is deployed out in the field. Fortunately, getting the same logs in Meadow.Cloud is really simple.

Setting up logs and events requires the following update in app.config.yaml:

MeadowCloud:
    Enabled: true

Then, all you need to register a new CloudLogger:

public override async Task Initialize()
{
    var cloudLogger = new CloudLogger();
    Resolver.Log.AddProvider(cloudLogger);
    ...
}

Once CloudLogger is registered, any logging done through Resolver.Log automatically gets recorded in Meadow.Cloud. Any logging done while the device is disconnected get stored locally and sent to Meadow.Cloud once a network connected is established.

Capturing Custom Events and Metrics​

Measuring and capturing sensor data is a very common application for embedded devices. Meadow makes this a trivial operation for any number of measurements with CloudLogger. First, we need to create and register a CloudLogger instance:

public override async Task Initialize()
{
    var cloudLogger = new CloudLogger();
    Resolver.Log.AddProvider(cloudLogger);
    Resolver.Services.Add(cloudLogger);
}

Then, call LogEvent(int eventId, string description, Dictionary<string, object> measurements) when a measurement needs to be made.

var cloudLogger = Resolver.Services.Get<CloudLogger>();
cloudLogger.LogEvent(1000, "environment reading", new Dictionary<string, object>()
{
    { "temperature", temperatureValue },
    { "humidity", humidityValue },
    { "pressure", pressureValue }
});

Note: The eventId parameter is a code used to distinguish events. Values under 100 are reserved for Meadow system events.

Viewing Logs and Events​

Log and event data is transmitted to Meadow.Cloud and indexed. To view and search data, visit https://www.meadowcloud.co/my/search. Freeform text entered in the search box will be used to filter the results. Additionally, the following filters can be applied:

  • Severity: severity:information, severity:warn, severity:error
  • Source: source:log or source:event
  • Device: device:[deviceId]

Sample Application​

For a reference on Logs and Events, view the Sample Application.

Recommendations

  • Enable automatic wifi connect and clock setting

Integrations​

Check out our Integrations to ingest log and event data into your own infrastructure via webhooks, Azure Event Hubs, Azure Event Grid, Datacake and more.

With your Meadow application logging events to Meadow.Cloud, check out the other Meadow.Cloud features.