Note: The project has has moved to theogravity/datadog-transports.
Send logs from electron-log to Datadog.
It uses datadog-api-client-typescript to send logs using the client v2.LogsApi#submitLog method.
- Performs batch sending of logs on a periodic basis, or when log capacity is reached in overall log batch size or count.
- Will retry failed sends.
- Can disable batch sending and always send for each log entry.
Note: This transport only works in the main process since the Datadog API client is not compatible with the renderer process.
yarn add electron-log-transport-datadog
import { dataDogTransport } from 'electron-log-transport-datadog';
import log from 'electron-log/src/main';
log.transports.datadog = dataDogTransport({
ddClientConf: {
authMethods: {
apiKeyAuth: 'YOUR_API_KEY',
},
},
onDebug: (msg) => {
console.log(msg);
},
onError: (err, logs) => {
console.error(err, logs);
},
});
export interface DDTransportOptions {
/**
* DataDog client configuration parameters.
* @see https://datadoghq.dev/datadog-api-client-typescript/interfaces/client.Configuration.html
*/
ddClientConf: ConfigurationParameters
/**
* Datadog server config for the client. Use this to change the Datadog server region.
* @see https://github.com/DataDog/datadog-api-client-typescript/blob/1e1097c68a437894b482701ecbe3d61522429319/packages/datadog-api-client-common/servers.ts#L90
*/
ddServerConf?: {
/**
* The datadog server to use. Default is datadoghq.com.
* Other values could be:
* - us3.datadoghq.com
* - us5.datadoghq.com
* - datadoghq.eu
* - ddog-gov.com
*/
site?: string
subdomain?: string
protocol?: string
}
/**
* The integration name associated with your log: the technology from which
* the log originated. When it matches an integration name, Datadog
* automatically installs the corresponding parsers and facets.
* @see https://docs.datadoghq.com/logs/log_collection/?tab=host#reserved-attributes
*/
ddsource?: string
/**
* Comma separated tags associated with your logs. Ex: "env:prod,org:finance"
*/
ddtags?: string
/**
* The name of the application or service generating the log events.
* Default is "Electron"
* @see https://docs.datadoghq.com/logs/log_collection/?tab=host#reserved-attributes
*/
service?: string
/**
* Called when the plugin is ready to process logs.
*/
onInit?: () => void
/**
* Error handler for when the submitLog() call fails.
*/
onError?: (err: any, logs?: Array<Record<string, any>>) => void
/**
* Define this callback to get debug messages from this transport
*/
onDebug?: (msg: string) => void
/**
* Number of times to retry sending the log before onError() is called.
* Default is 5.
*/
retries?: number
/**
* Interval in which logs are sent to Datadog.
* Default is 3000 milliseconds.
*/
sendIntervalMs?: number
/**
* Set to true to disable batch sending and send each log as it comes in. This disables
* the send interval.
*/
sendImmediate?: boolean
/**
* Set to assign a field to store all object metadata in the log object that is sent to datadog.
*/
metadataField?: string;
/**
* Set to re-assign the field that stores all array metadata in the log object that is sent to datadog.
* Default is "arrayData".
*/
arrayDataField?: string;
}
It is recommended you use loglayer
with electron-log
so you have a consistent logging experience across your application. It will provide standard ways
to define metadata, handle errors, and more.
{
"message": "This is a log message",
"date": <millisecond unix timestamp>,
"level": "info",
"arrayData": [
"some",
"array",
"data"
],
...<metadata>
}
Because electron-log
lets you shove anything into the log methods, the following logic is applied in forming
the log entry to send to Datadog:
- If the log entry contains a string, it will be used as the
message
field. Multiple strings will be concatenated. - If the log entry contains an object, the fields will be added to
metadata
(the log entry root).- You can set a field to store all object metadata in the log object that is sent to datadog using the
metadataField
option.
- You can set a field to store all object metadata in the log object that is sent to datadog using the
- If the log entry contains an array, it will be added to the
arrayData
field.- You can set a field to store all array metadata in the log object that is sent to datadog using the
arrayDataField
option.
- You can set a field to store all array metadata in the log object that is sent to datadog using the
You'll probably want to associate a user to the logs you send to datadog, or add other kinds of data.
If you use loglayer
, you can
use the context feature to add something like a userId
to the metadata. This will be sent to Datadog with each log entry.
import { LogLayer } from 'loglayer';
import log from 'electron-log/src/main';
const logger = new LogLayer({
logger: {
instance: log,
type: LoggerType.ELECTRON_LOG,
},
// See LogLayer documentation for more options
// like setting the field for context data
context: {
fieldName: 'context',
},
metadata: {
fieldName: 'metadata',
},
}).withContext({
// or whatever you use to identify the user
userId: '1234',
electronVersion: "v1.2.3"
});
export function getLogger() {
return logger;
}
// Will send the log entry to Datadog with the metadata field containing the userId, electronVersion and some metadata.
getLogger().withMetadata({ some: 'metadata' }).info('This is a log message');