OpenTelemetry Configuration

OpenTelemetry lets you monitor system behavior and troubleshoot issues in CompuTec AppEngine and SAP Business One.

This guide explains how to connect your environment to a telemetry backend (such as Grafana Cloud) using an OpenTelemetry profile, and how to view logs, traces, and metrics.

Configure OpenTelemetry Profile

To configure OpenTelemetry in OpenTelemetry-compatible backend, for example, Grafana Cloud, follow these steps:

1. Visit Grafana website and create an account.

2. After logging in, create a new Stack.

   

3. Go to My account.

   

4. Click your stack name to manage it.

   

5. Find OpenTelemetry integration and click Configure.

   

6. In Password / API Token, click Generate now.

   

7. Name the token, set an expiry (or no expiry), and click Create token.

   

8. In CompuTec AppEngine Administration Panel, navigate to System > Telemetry Profiles.

   

9. Create a new profile by clicking the copy icon next to the predefined OpenTelemetry_All profile.

   

10. Copy Endpoint for sending OLTP signals from Grafana.com.

    

11. Paste it to all Endpoint fields in your new CompuTec AppEngine Open Telemetry profile.

    

12. Copy Environmental Variable OTLP Header from Grafana.com.

    

13. Paste it to all Headers in your new CompuTec AppEngine Open Telemetry profile.

    

14. In CompuTec AppEngine Administration Panel, click Save.

    

15. Done! Now you can see this profile on the list in CompuTec AppEngine Administration Panel > System > Telemetry Profiles.

Assign OpenTelemetry Profile to CompuTec AppEngine

To assign a profile to the CompuTec AppEngine instance, follow these steps:

1. Navigate to CompuTec AppEngine Administration Panel > Configuration > AppEngine Servers.

   

2. Clcik the edit icon next to the chosen CompuTec AppEngine instance.

   

3. Click the OpenTelemetry profile you want to assign.

   

4. Now you can see the OpenTelemetry profile name in the list.

   

5. Restart the CompuTec AppEngine Service to apply the changes.

Assign the OpenTelemetry Profile to SAP Business One

To assign the OpenTelemetry profile to the Computec AppEngine company, follow these steps:

1. Go to CompuTec AppEngine Administration Panel > Configuration.

   

2. Choose the company name from the list to see its details.

   

   note

   You can assign OpenTelemetry Profiles:

   • To all users in the company
   • To specific users needing tailored configurations

3. To assign the default profile to all users in the company, choose the company name from the list to see its details.

   

4. Click the edit icon next to Telemetry Profile.

   

5. Choose the OpenTelemetry profile from the list.

   

6. Done! Now you can see the Telemetry Profile name assigned to your company.

   

7. To assign the profile for a specific user, navigate to Telemetry Profiles in your company details.

   

8. Click Assign profile.

   

9. Type the user name, click the edit icon to assign the chosen Telemetry Profile, and click Create Assignment.

   

10. Restart Sap Business One to see the changes.

View the OpenTelemetry Profiles and Logs

1. In Grafana, click Launch Grafana Cloud.

   

2. Navigate to Explore.

   

3. Choose the exploration method from the list:

   • traces: View time-based traces
   • logs: Inspect logs
   • prom: Analyze metrics

   

4. Done! Now you can explore telemetry.

   

   Service Name - Under the Resource section, locate and input the User Name and Database Id to ensure accurate telemetry tracking.

   • Computec.AppEngine.Host – CompuTec AppEngine Service
   • Computec.Start – SAP Business One Plugin Activity