June Updates

🔧 Debugging Tools, New Test Integration, and Coros Planned Workouts: Enhancing Development and User Experience

TL;DR:

Debugging tools have been enabled for the Terra API, providing valuable metrics in webhooks for tracing and troubleshooting. A new test integration allows developers to incorporate Terra API-specific tests in their CI/CD pipeline. Coros now supports pushing planned workouts, enhancing the integration of workout plans with their devices.

Debugging Tools

🛠️ What?

New debugging tools have been enabled for the Terra API, offering developers insights into the performance and execution of webhooks. The headers of webhooks now include metrics such as the duration it took for the webhook to go through Terra’s service before reaching you, as well as a trace ID for further troubleshooting assistance.

⚙️ How?

By leveraging the power of OpenTelemetry, we have instrumented our entire codebase to gain deep insights into the inner workings of our services. This instrumentation allows us to provide valuable metrics and tracing capabilities to developers for enhanced observability.

🤔 Why?

We understand that our customers value transparency and want more insight into Terra’s services' performance. By offering these debugging tools, developers can better understand the behavior and timing of webhooks, leading to improved troubleshooting and optimization of their integration with Terra. Additionally, these tools enable us to have better observability, enhancing further and optimizing our services.

New Test Integration

🧪 What?

A new test integration has been released, enabling developers to incorporate authentication method testing and generic data requesting in their CI/CD pipeline. This integration allows developers to mock authentication and generate every possible data field in Terra’s data models.

⚙️ How?

We have created a “dummy provider” specifically for testing purposes, which always permits authentication. This allows developers to simulate various authentication scenarios and test their handling of different data fields.

🤔 Why?

Our users have expressed the need for including Terra API-specific tests in their CI/CD pipeline. By providing this new test integration, developers can now build automated testing processes to ensure their systems can handle every event type that Terra might send. This allows for greater confidence in the reliability and stability of their integrations with Terra.

Coros Planned Workouts

🏋️‍♂️ What?

Coros now supports pushing planned workouts directly to their devices. Users can now seamlessly see and follow their workout plans with their Coros devices.

⚙️ How?

Through a strong partnership with Coros, we have gained access to their platform’s capabilities, enabling us to export planned workouts directly to Coros devices. This integration ensures that users can easily access and follow their workout plans within the Coros ecosystem.

🤔 Why?

Planned workout integrations are becoming increasingly popular among fitness apps. As demand for this functionality grows, we strive to expand our support for various devices and apps that allow users to integrate their workout plans seamlessly. By partnering with Coros, we can provide users with an enhanced experience, allowing them to follow their workout plans with their Coros devices effortlessly.

Introducing debugging tools, a new test integration, and the support for Coros planned workouts all enhance the Terra ecosystem's development process and user experience. The debugging tools provide valuable insights for tracing and troubleshooting, the new test integration enables automated testing of Terra-specific scenarios, and the Coros integration allows users to access and follow their planned workouts seamlessly. These additions showcase our commitment to continuously improving and expanding our offerings to meet the evolving needs of our customers.