wehub-resource-sync
4b6817381b
CI (OpenClaw E2E) / openclaw test (push) Has been cancelled
CI / coverage-report (push) Has been cancelled
CI / test-kubernetes (push) Has been cancelled
CI / should-run-thorough (push) Has been cancelled
CI / test-thorough (cloudwatch-demo) (push) Has been cancelled
CI / test-thorough (flink-ecs) (push) Has been cancelled
CI / test-thorough (upstream-lambda) (push) Has been cancelled
CI / test-thorough (prefect-ecs-fargate) (push) Has been cancelled
Release / build-binaries (zip, opensre.exe, onefile, windows-latest, windows-x64) (push) Has been cancelled
Benchmark image — build + push to ECR (any adapter) / build + push (push) Has been cancelled
CI / quality (ubuntu-latest) (push) Has been cancelled
CI / test (tools-runtime) (push) Has been cancelled
CI / test (e2e-general) (push) Has been cancelled
CI / test (cli-runtime) (push) Has been cancelled
CI / test (e2e-provider-and-openclaw) (push) Has been cancelled
CI / test (integrations-and-misc) (push) Has been cancelled
Release / verify (push) Has been cancelled
Release / build-python-dist (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, macos-15-intel, darwin-x64) (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, macos-latest, darwin-arm64) (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, ubuntu-22.04, linux-x64) (push) Has been cancelled
Release / publish-release (push) Has been cancelled
Release / publish-main-release (push) Has been cancelled
Interactive Shell Live (PR + post-merge) / turn-checks (no-LLM) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
Interactive Shell Live (PR + post-merge) / turn-live shard ${{ matrix.shard_index }} (push) Has been cancelled
Release / prepare (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, ubuntu-22.04-arm, linux-arm64) (push) Has been cancelled
Synthetic Deterministic Tests / Synthetic offline (deterministic) (push) Has been cancelled
75 lines
2.3 KiB
Plaintext
75 lines
2.3 KiB
Plaintext
---
|
||
title: "Bash"
|
||
description: "Using Tracer with Bash scripts"
|
||
---
|
||
|
||
Tracer can monitor any Bash-based pipeline, from small scripts to large chained commands, giving instant visibility into each command’s behavior.
|
||
|
||
## Why use Tracer in combination with Bash
|
||
|
||
Many scientific or data pipelines rely on simple shell scripts that lack structured logging.
|
||
Tracer automatically adds observability:
|
||
|
||
- Traces every subprocess (even background jobs)
|
||
- Captures CPU, memory, and I/O usage for each command
|
||
- Provides a single timeline of all steps
|
||
- Enables root-cause debugging for failures or stalls
|
||
- Works for scripts, loops, and complex shell pipelines
|
||
|
||
## Getting started
|
||
### Prerequisites
|
||
|
||
- Bash 4.0 or higher
|
||
- Tracer installed on [your operating system](/environments/overview)
|
||
|
||
### Just run your pipeline, Tracer will automatically attach
|
||
|
||
If Tracer is already installed on your operating system, you only need to enable the Tracer agent for pipelines that have not been run with Tracer before.<br/>
|
||
In that case, run the following command:
|
||
|
||
```bash
|
||
sudo tracer init --token <your-token>
|
||
```
|
||
<Info> Go to our [onboarding](https://app.tracer.cloud/dashboard) to get your own personal token</Info>
|
||
|
||
When running this command, you will be asked to name your pipeline for clear labeling in the dashboard.
|
||
|
||
## Examples
|
||
|
||
Run a Bash script under Tracer:
|
||
|
||
```bash
|
||
bash my_analysis.sh
|
||
```
|
||
|
||
or launch the Tracer demo workflow:
|
||
|
||
```bash
|
||
sudo tracer demo
|
||
```
|
||
|
||
Once the pipeline starts, open the Tracer dashboard, and you’ll see each command as a timeline step updating in real time.
|
||
|
||
<Card href="https://app.tracer.cloud/">
|
||
<img
|
||
className="block dark:hidden"
|
||
src="/images/logo/tracer/Tracer Full Body - Black.png"
|
||
alt="Tracer Logo"
|
||
style={{ width: '10%', height: 'auto', marginBottom: '1rem' }}
|
||
/>
|
||
<img
|
||
className="hidden dark:block"
|
||
src="/images/logo/tracer/Tracer Full Body - Black.png"
|
||
alt="Tracer Logo"
|
||
style={{ width: '10%', height: 'auto', marginBottom: '1rem' }}
|
||
/>
|
||
|
||
<div style={{ fontSize: '1.3rem', fontWeight: '700', marginBottom: '1 rem', color: 'inherit' }}>
|
||
Watch your pipeline run in the Tracer dashboard
|
||
</div>
|
||
|
||
<div style={{ color: 'inherit' }}>
|
||
View real-time metrics, resource usage, and performance insights for your pipeline runs.
|
||
</div>
|
||
</Card>
|