-
Notifications
You must be signed in to change notification settings - Fork 74
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* docs(config): fix agent config, fix config root page, add connecting to tracing backends overview page * Update docs/docs/configuration/connecting-to-data-stores/overview.mdx Co-authored-by: Daniel Baptista Dias <[email protected]> --------- Co-authored-by: Daniel Baptista Dias <[email protected]>
- Loading branch information
1 parent
823e609
commit 8166642
Showing
7 changed files
with
127 additions
and
46 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,30 @@ | ||
--- | ||
id: cloud-agent | ||
title: Configuring the Tracetest Cloud Agent (Public Access) | ||
description: The Tracetest Agent enables Tracetest to access your application under test and to ingest trace data from your OpenTelemetry Collector or tracing backend. Learn how to configure the Tracetest Agent that runs in your environment as an executable, Docker container, or in your Cloud Native infrastructure. | ||
keywords: | ||
- tracetest | ||
- trace-based testing | ||
- observability | ||
- distributed tracing | ||
- testing | ||
image: https://res.cloudinary.com/djwdcmwdz/image/upload/v1698686403/docs/Blog_Thumbnail_14_rsvkmo.jpg | ||
--- | ||
|
||
The Tracetest Cloud Agent allows you to run Tracetest tests against public facing endpoints without deploying the Tracetest Agent locally. This allows you to trigger tests against public endpoints and collect trace data from either public tracing backends or, alternatively, directly receive incoming OTLP data. | ||
|
||
Tracetest Cloud Agent is the same as Tracetest Agent but is managed and running as part of your Tracetest account. | ||
|
||
## Start Tracetest Cloud Agent | ||
|
||
Tracetest Cloud Agent runs in your Tracetest account. | ||
|
||
[Sign in to Tracetest](https://app.tracetest.io/) and follow the instructions on the `Settings > Access` page. | ||
|
||
Select `Application is publicly accessible`. | ||
|
||
![](https://res.cloudinary.com/djwdcmwdz/image/upload/v1712602150/docs/app.tracetest.io_organizations_ttorg_2179a9cd8ba8dfa5_environments_ttenv_597cf82c754c2a01_settings_2_bs2zc9.png) | ||
|
||
## Configure Tracetest Cloud Agent | ||
|
||
Once started, Tracetest Cloud Agent exposes TLS port `443` to ingest traces via `gRPC` and `HTTP` and is responsible for running tests. [Read the detailed concepts here](/concepts/cloud-agent). |
56 changes: 56 additions & 0 deletions
56
docs/docs/configuration/connecting-to-data-stores/overview.mdx
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,56 @@ | ||
--- | ||
id: overview | ||
title: Connecting to Tracing Backends | ||
description: Tracetest allows you to quickly build integration and end-to-end tests, powered by your OpenTelemetry traces. Learn how to connect tracing backends. | ||
keywords: | ||
- tracetest | ||
- trace-based testing | ||
- observability | ||
- distributed tracing | ||
- testing | ||
image: https://res.cloudinary.com/djwdcmwdz/image/upload/v1698686403/docs/Blog_Thumbnail_14_rsvkmo.jpg | ||
--- | ||
|
||
Tracetest supports two types of tracing backend integrations. | ||
|
||
## Native Connection (Polling) | ||
|
||
When using a tracing backend integration that supports the native connection, Tracetest will pull telemetry data directly from your tracing backend for every test run. | ||
|
||
## OTLP Ingest Endpoint | ||
|
||
When using a tracing backend integration that does not support a native connection, or no tracing backend at all, you'll resort to using the Tracetest OTLP ingest endpoint. [Tracetest Agent](/configuration/agent) exposes an OTLP endpoint that listens for trace data on ports `4317` (gRPC) and `4318` (HTTP). As does [Tracetest Cloud Agent](/configuration/cloud-agent), but uses the same TLS port `443` for OTLP ingestion. | ||
|
||
## Supported Tracing Backends | ||
|
||
Currently, Tracetest supports the following data stores. Click on the respective data store to view configuration examples: | ||
|
||
- [AWS X-Ray](/configuration/connecting-to-data-stores/awsxray) | ||
- [Azure App Insights](/configuration/connecting-to-data-stores/azure-app-insights) | ||
- [Datadog](/configuration/connecting-to-data-stores/datadog) | ||
- [Dynatrace](/configuration/connecting-to-data-stores/dynatrace) | ||
- [Elastic APM](/configuration/connecting-to-data-stores/elasticapm) | ||
- [Grafana Tempo](/configuration/connecting-to-data-stores/tempo) | ||
- [Honeycomb](/configuration/connecting-to-data-stores/honeycomb) | ||
- [Instana](/configuration/connecting-to-data-stores/instana) | ||
- [Jaeger](/configuration/connecting-to-data-stores/jaeger) | ||
- [Lightstep](/configuration/connecting-to-data-stores/lightstep) | ||
- [New Relic](/configuration/connecting-to-data-stores/new-relic) | ||
- [OpenSearch](/configuration/connecting-to-data-stores/opensearch) | ||
- [OpenTelemetry Collector](/configuration/connecting-to-data-stores/opentelemetry-collector) | ||
- [SignalFX](/configuration/connecting-to-data-stores/signalfx) | ||
- [SigNoz](/configuration/connecting-to-data-stores/signoz) | ||
- [Sumo Logic](/configuration/connecting-to-data-stores/sumologic) | ||
|
||
## Using Tracetest without a Tracing Backend (OTLP ingest endpoint) | ||
|
||
Another option is to send traces directly to Tracetest using the OpenTelemetry Collector. And, you don't have to change your existing pipelines to do so. | ||
|
||
View [configuration for OpenTelemetry Collector](/configuration/connecting-to-data-stores/opentelemetry-collector) for more details. | ||
|
||
## Tracing Backend Configuration Examples | ||
|
||
- View the [`examples` folder of the Tracetest GitHub repo](https://github.com/kubeshop/tracetest/tree/main/examples). | ||
- Follow the [**Recipes**](/examples-tutorials/recipes) for guided walkthroughs of sample use cases. | ||
|
||
We will be adding new data stores over the next couple of months - [let us know](https://github.com/kubeshop/tracetest/issues/new/choose) any additional data stores you would like to see us support. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters