This Electron application demonstrates basic OpenTelemetry instrumentation for monitoring and tracing, designed to work with SigNoz Cloud for visualization. It showcases how to trace application startup, simulate long-running tasks, read file contents, and handle user interactions with OpenTelemetry in an Electron app.
To run this Electron OpenTelemetry example application on your system and visualize traces in SigNoz Cloud, follow the steps outlined below. These instructions assume you have Node.js and npm installed. If not, please install them from Node.js official site.
First, clone the repository to your local machine:
git clone https://github.com/YOUR_GITHUB/YOUR_REPOSITORY.git
cd YOUR_REPOSITORY
Inside the project directory, install the necessary dependencies:
npm install
Once the dependencies are installed, you can start the Electron application with:
npm start
This command launches the Electron app window and begins tracing application activities.
To view the traces generated by your application:
- Ensure your SigNoz Cloud instance is up and running and correctly configured in
tracing.js
. - Perform actions within the application (e.g., clicking the demonstrated button, and waiting for the application to read the file content).
- Access your SigNoz Cloud dashboard Service Tab to view your application.
You should see a service called electronjs-otel-sample-app
in your Service Tab. You can change the name of your service in your tracing.js
.
In the tracing.js
file, replace
- {region} with the region of your SigNoz Cloud instance.
- with the ingestion key of your SigNoz cloud instance.
You can find these values under Settings -> Ingestion Settings of your SigNoz Cloud instance.
Read the comments in tracing.js
and index.js
files to get a better understanding of how the instrument works. OpenTelemetry doesn't provide auto-instrumentation for ElectronJS so you have to manually instrument all the functions that you want to collect the traces for.