Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs(landing page): Overhaul docs landing page introduction (#2967)
* go work sum * docs(intro): 1st revamp of intro * docs(landing page): complete overhaul * docs(landing): typo * Update docs/docs/index.mdx Co-authored-by: Julianne Fermi <julianne@kubeshop.io> --------- Co-authored-by: Julianne Fermi <julianne@kubeshop.io>
- Loading branch information
1 parent
c35a5c7
commit 1957e07
Showing
17 changed files
with
1,982 additions
and
758 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
File renamed without changes.
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
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 was deleted.
Oops, something went wrong.
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,117 @@ | ||
| --- | ||
| id: index | ||
| title: Welcome to Tracetest Docs! 👋 | ||
| description: Tracetest allows you to quickly build integration and end-to-end tests, powered by your OpenTelemetry traces. | ||
| hide_table_of_contents: false | ||
| keywords: | ||
| - tracetest | ||
| - trace-based testing | ||
| - observability | ||
| - distributed tracing | ||
| - testing | ||
| image: https://res.cloudinary.com/djwdcmwdz/image/upload/v1689693872/docs/Blog_Thumbnail_28_ugy2yy.png | ||
| breadcrumb_label: Nothing | ||
| --- | ||
|
|
||
| import CodeBlock from '@theme/CodeBlock'; | ||
|
|
||
| Tracetest is a trace-based testing tool for building integration and end-to-end tests in minutes using your [OpenTelemetry](https://opentelemetry.io/docs/getting-started/) traces. Assert against your trace data at every point of a request transaction. | ||
|
|
||
| ```mdx-code-block | ||
| import {GettingStartedGuideCardsRow} from '@site/src/components/GettingStartedGuide'; | ||
| <GettingStartedGuideCardsRow /> | ||
| ``` | ||
|
|
||
| ## Why Tracetest? | ||
|
|
||
| You can: | ||
|
|
||
| - Define tests and assertions against every single microservice that a trace goes through. | ||
| - Define **assertions against** both the **response and trace data**. | ||
| - Ensure both your response and the underlying processes worked correctly, quickly, and without errors. | ||
| - Work with your existing distributed tracing solution. | ||
| - Build tests based on your already instrumented system. | ||
| - Define multiple transaction triggers: | ||
| - HTTP requests | ||
| - GRPC requests | ||
| - trace IDs | ||
| - and many more... | ||
| - Save and run the tests manually or via CI build jobs. | ||
| - Write detailed trace-based tests as: | ||
| - End-to-end tests | ||
| - Integration tests | ||
| - Build tests in minutes. | ||
|
|
||
| <div className="row"> | ||
| <div className="col col--12 margin-bottom--lg"> | ||
| <div> | ||
| <div className="card__body"> | ||
| <p align="center"> | ||
| <b>Visually - Build tests in the Web UI</b> | ||
| </p> | ||
| </div> | ||
| <div className="card__footer"> | ||
| <img src="https://res.cloudinary.com/djwdcmwdz/image/upload/v1688476657/docs/screely-1688476653521_omxe4r.png" /> | ||
| </div> | ||
| </div> | ||
| </div> | ||
| <div className="col col--12 margin-bottom--lg"> | ||
| <div> | ||
| <div className="card__body"> | ||
| <p align="center"> | ||
| <b>Programmatically - Build tests in YAML</b> | ||
| </p> | ||
| </div> | ||
| <div className="card__footer"> | ||
| <CodeBlock | ||
| language="yaml" | ||
| > | ||
| {` | ||
| type: Test | ||
| spec: | ||
| id: Yg9sN-94g | ||
| name: Pokeshop - Import | ||
| description: Import a Pokemon | ||
| trigger: | ||
| type: http | ||
| httpRequest: | ||
| url: http://demo-api:8081/pokemon/import | ||
| method: POST | ||
| headers: | ||
| - key: Content-Type | ||
| value: application/json | ||
| body: '{"id":52}' | ||
| specs: | ||
| - name: 'All Database Spans: Processing time is less than 100ms' | ||
| selector: span[tracetest.span.type="database"] | ||
| assertions: | ||
| - attr:tracetest.span.duration < 100ms | ||
| `} | ||
| </CodeBlock> | ||
| </div> | ||
| </div> | ||
| </div> | ||
| </div> | ||
|
|
||
| ## Architecture | ||
|
|
||
| Understand how Tracetest works. | ||
|
|
||
| 1. Trigger a test and generate a trace response. | ||
| 2. Fetch traces to render and analyze them. | ||
| 3. Add assertions to traces. | ||
| 4. See test results. | ||
| 5. Run tests as part of CI/CD pipelines. | ||
|
|
||
|  | ||
|
|
||
| ## Who uses Tracetest? | ||
|
|
||
| Our users are typically developers or QA engineers building distributed systems with microservices using back-end languages like Go, Rust, Node.js and Python. | ||
|
|
||
| ## What makes Tracetest special? | ||
|
|
||
| Tracetest can be compared with Cypress or Selenium; however Tracetest is fundamentally different. | ||
|
|
||
| Cypress and Selenium are constrained by using the browser for testing. Tracetest bypasses this entirely by using your existing OpenTelemetry instrumentation and trace data to run tests and assertions against traces in every step of a request transaction. |
Oops, something went wrong.