### Install GlitchTip CLI using Install Script

Source: https://glitchtip.com/documentation/cli

Installs the GlitchTip CLI by downloading the appropriate binary for your OS and architecture. It attempts to install to /usr/local/bin, falling back to ~/.local/bin if necessary.

```bash
curl -fsSL https://glitchtip.com/install.sh | sh
```

--------------------------------

### Example GlitchTip CLI Configuration File

Source: https://glitchtip.com/documentation/cli

An example INI-formatted configuration file demonstrating how to set authentication tokens and default organization/project values.

```ini
[auth]
token=your-api-token

[defaults]
url=https://your-glitchtip.example.com
org=my-org
project=my-project
```

--------------------------------

### Install GlitchTip CLI from Source

Source: https://glitchtip.com/documentation/cli

Installs the GlitchTip CLI using Cargo, the Rust package manager. Ensure you have Rust installed before running this command.

```bash
cargo install glitchtip-cli
```

--------------------------------

### Install Python Dependencies with uv

Source: https://glitchtip.com/documentation/install

After creating a Python virtual environment, use uv to synchronize and install all necessary Python dependencies for GlitchTip.

```bash
uv sync
```

--------------------------------

### Install GlitchTip Helm Chart

Source: https://glitchtip.com/documentation/install

Install the GlitchTip Helm chart on your Kubernetes cluster. Ensure you have a values.yaml file or use --set for configuration.

```bash
helm install glitchtip glitchtip/glitchtip -f your-values.yaml
```

--------------------------------

### Send a Test Event

Source: https://glitchtip.com/documentation/cli

Sends a simple test event message to your GlitchTip instance to verify the CLI setup and connectivity.

```bash
glitchtip-cli send-event -m "Test event from CLI"
```

--------------------------------

### Clone GlitchTip Backend Repository

Source: https://glitchtip.com/documentation/install

Clone the latest Django backend release tag to begin the manual installation process. Note the version number for subsequent steps.

```bash
git clone or download the latest Django backend [release tag](https://gitlab.com/glitchtip/glitchtip-backend/-/tags)
```

--------------------------------

### Add Helm Chart Repository

Source: https://glitchtip.com/documentation/install

Add the GlitchTip Helm chart repository to your Helm configuration. This command is necessary before installing the chart.

```bash
helm repo add glitchtip https://gitlab.com/api/v4/projects/16325141/packages/helm/stable
```

--------------------------------

### Upload JavaScript Source Maps with GlitchTip CLI

Source: https://glitchtip.com/documentation/error-tracking

Use the GlitchTip CLI to inject debug IDs and upload source maps for JavaScript projects. This helps in getting readable stack traces for errors.

```bash
glitchtip-cli sourcemaps inject ./dist
glitchtip-cli sourcemaps upload ./dist --org my-org --project my-project
```

--------------------------------

### Run GlitchTip Worker

Source: https://glitchtip.com/documentation/install

Start the background task worker using the provided run script. This is essential for asynchronous operations within GlitchTip. Configuration with init systems like systemd or supervisor is recommended.

```bash
./bin/run-worker
```

--------------------------------

### Log Docker Compose Service Output

Source: https://glitchtip.com/documentation/contribute

To view the console output from a Docker Compose service, use the 'docker-compose logs' command followed by the service name. For example, 'docker-compose logs web' will show logs for the 'web' service.

```bash
docker-compose logs web
```

--------------------------------

### Set Event Store Debug Mode

Source: https://glitchtip.com/documentation/contribute

To enable detailed logging for event storage, set the EVENT_STORE_DEBUG environment variable to "True". This is typically done in the docker-compose.yml file for Docker Compose setups.

```yaml
EVENT_STORE_DEBUG: "True"
```

--------------------------------

### Migrate the Database

Source: https://glitchtip.com/documentation/install

Apply database migrations to set up the necessary schema for GlitchTip.

```bash
./manage.py migrate
```

--------------------------------

### Download Frontend Assets

Source: https://glitchtip.com/documentation/install

Download the latest frontend code using wget. Replace `<VERSION HERE>` with the specific version tag obtained in the previous step.

```bash
wget https://gitlab.com/api/v4/projects/15449363/jobs/artifacts/<VERSION HERE>/download?job=build-assets -O assets.zip
```

--------------------------------

### Query Logs via CLI

Source: https://glitchtip.com/documentation/logs

Use the GlitchTip CLI to list logs for a specific organization. Replace `your-org` with your actual organization name.

```bash
glitchtip-cli logs list --org your-org
```

--------------------------------

### Record GlitchTip Deployments

Source: https://glitchtip.com/documentation/cli

Commands for recording new deployments and listing existing deployments for a specific release.

```bash
glitchtip-cli deploys new 1.0.0 --env production --org my-org --project my-project
glitichtip-cli deploys list 1.0.0 --org my-org --project my-project
```

--------------------------------

### Log in to GlitchTip Instance (API Token)

Source: https://glitchtip.com/documentation/cli

Authenticates with your GlitchTip instance using an API token. This command saves credentials to a local .sentryclirc file by default.

```bash
glitchtip-cli --url https://your-glitchtip.example.com login
```

--------------------------------

### Configure Local Filesystem Cold Storage Directory

Source: https://glitchtip.com/documentation/install

Alternatively to S3, specify a local directory path for cold storage. This allows archiving data to the local filesystem instead of an S3 bucket.

```bash
GLITCHTIP_COLD_STORAGE_DIR=/path/to/cold/storage
```

--------------------------------

### Manage GlitchTip Uptime Monitors

Source: https://glitchtip.com/documentation/cli

Commands for managing uptime monitors, including listing, running commands with heartbeats, creating new monitors, and deleting existing ones.

```bash
# List monitors
glitichtip-cli monitors list --org my-org

# Run a command and send a heartbeat on success
glitichtip-cli monitors run <ENDPOINT_UUID> -- python manage.py scheduled_task

# Create a monitor
glitichtip-cli monitors create "My Monitor" --url https://example.com --org my-org --project my-project

# Delete a monitor
glitichtip-cli monitors delete <MONITOR_ID> --org my-org
```

--------------------------------

### Manage GlitchTip Releases

Source: https://glitchtip.com/documentation/cli

A collection of commands for managing releases, including creating, finalizing, associating commits, listing, and deleting releases.

```bash
# Create a new release
glitichtip-cli releases new 1.0.0 --org my-org --project my-project

# Finalize a release
glitichtip-cli releases finalize 1.0.0 --org my-org --project my-project

# Associate commits with a release (auto-discovers from git)
glitichtip-cli releases set-commits 1.0.0 --auto --org my-org --project my-project

# List releases
glitichtip-cli releases list --org my-org --project my-project

# Delete a release
glitichtip-cli releases delete 1.0.0 --org my-org --project my-project
```

--------------------------------

### Enable MCP Server

Source: https://glitchtip.com/documentation/mcp

Set this environment variable to enable the MCP server on your GlitchTip instance. The MCP endpoint will then be available at the specified URL.

```bash
GLITCHTIP_ENABLE_MCP=True
```

--------------------------------

### Configure Tracing with tracesSampleRate (Python)

Source: https://glitchtip.com/documentation/performance

Enable transaction tracing in your Sentry SDK by setting `tracesSampleRate` to a value between 0.0 and 1.0. A lower rate is recommended for production to minimize overhead.

```python
import sentry_sdk

sentry_sdk.init(
    dsn="YOUR_DSN",
    traces_sample_rate=0.1,  # capture 10% of transactions
)
```

--------------------------------

### Check GlitchTip CLI Info

Source: https://glitchtip.com/documentation/cli

Displays information about the current GlitchTip CLI configuration and authentication status.

```bash
glitchtip-cli info
```

--------------------------------

### Enable Logs in JavaScript SDK

Source: https://glitchtip.com/documentation/logs

Initialize the JavaScript Sentry SDK with `enableLogs: true` to send logs. Ensure `autoSessionTracking` is set to `false` as GlitchTip does not support sessions.

```javascript
import * as Sentry from "@sentry/browser";

Sentry.init({
  dsn: "https://your-dsn@your-glitchtip.example.com/1",
  tracesSampleRate: 0.01,
  autoSessionTracking: false,
  enableLogs: true,
});
```

--------------------------------

### Configure Nginx for GlitchTip

Source: https://glitchtip.com/documentation/install

This Nginx configuration directs traffic for glitchtip.example.com to the GlitchTip Docker Compose instance running on port 8000. Ensure your server_name matches your domain.

```nginx
server {
    server_name glitchtip.example.com;
    access_log  /var/log/nginx/access.log;
    client_max_body_size 40M;

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
```

--------------------------------

### Enable DuckDB for Cold Storage

Source: https://glitchtip.com/documentation/install

Set this environment variable to true to enable the use of DuckDB for querying archived data in cold storage. This is essential for implementing a hot/cold storage architecture.

```bash
GLITCHTIP_ENABLE_DUCKDB=true
```

--------------------------------

### Configure Tracing with tracesSampleRate (JavaScript)

Source: https://glitchtip.com/documentation/performance

Enable transaction tracing in your Sentry SDK by setting `tracesSampleRate` to a value between 0.0 and 1.0. A lower rate is recommended for production to minimize overhead.

```javascript
Sentry.init({
  dsn: "YOUR_DSN",
  tracesSampleRate: 0.1,
});
```

--------------------------------

### Configure Claude Desktop MCP Server

Source: https://glitchtip.com/documentation/mcp

Add GlitchTip as an MCP server in Claude Desktop's configuration. This allows Claude Desktop to connect to your GlitchTip instance for data interaction. Claude Desktop handles the OAuth flow automatically.

```json
{
  "mcpServers": {
    "glitchtip": {
      "url": "https://your-glitchtip.example.com/mcp"
    }
  }
}
```

--------------------------------

### Collect Static Files

Source: https://glitchtip.com/documentation/install

Gather all static files required by GlitchTip into a single location for efficient serving by the web server.

```bash
./manage.py collectstatic
```

--------------------------------

### Query GlitchTip Logs

Source: https://glitchtip.com/documentation/cli

Queries and lists logs from your GlitchTip instance.

```bash
glitchtip-cli logs list --org my-org
```

--------------------------------

### Upload Source Maps

Source: https://glitchtip.com/documentation/cli

Commands for preparing and uploading source maps to GlitchTip. 'inject' adds debug IDs to source files, and 'upload' sends the source maps associated with a release.

```bash
# Inject debug IDs into source files
glitichtip-cli sourcemaps inject ./dist

# Upload source maps with debug IDs
glitichtip-cli sourcemaps upload ./dist --release 1.0.0 --org my-org --project my-project
```

--------------------------------

### Log in to GlitchTip Instance (OAuth)

Source: https://glitchtip.com/documentation/cli

Authenticates with your GlitchTip instance using browser-based OAuth. This method is an alternative to using an API token.

```bash
glitchtip-cli --url https://your-glitchtip.example.com login --method oauth
```

--------------------------------

### Enable HSTS Preload

Source: https://glitchtip.com/documentation/install

When true, this flag indicates that the site should be included in the HSTS preload list, further enhancing security by ensuring browsers always connect via HTTPS.

```bash
SECURE_HSTS_PRELOAD=true
```

--------------------------------

### Configure Sentinel URL for Cache

Source: https://glitchtip.com/documentation/install

Provide the host and port of your Sentinel instances for high availability cache configuration. This setting is comma-separated for multiple Sentinels and does not include the protocol or password.

```bash
CACHE_SENTINEL_URL=valkey:26379
```

--------------------------------

### Enable Logs in Python SDK

Source: https://glitchtip.com/documentation/logs

Initialize the Python Sentry SDK with `enable_logs=True` to send logs. Logs are automatically forwarded from the standard `logging` module or can be sent directly using `sentry_sdk.logger.info(...)`.

```python
import sentry_sdk

sentry_sdk.init(
    dsn="https://your-dsn@your-glitchtip.example.com/1",
    traces_sample_rate=0.01,  # 1% of transactions — adjust to your needs
    auto_session_tracking=False,  # GlitchTip does not support sessions
    enable_logs=True,
)
```

--------------------------------

### Create Django Superuser

Source: https://glitchtip.com/documentation/install

Use this command to create a superuser account for accessing the Django Admin interface. This allows full management of users and application settings.

```bash
./manage.py createsuperuser
```

--------------------------------

### Configure Performance Event Sampling Rate

Source: https://glitchtip.com/documentation/frequently-asked-questions

Set the `tracesSampleRate` option to control the percentage of performance events sent to GlitchTip. Recommended for reducing monthly event usage.

```javascript
tracesSampleRate: 0.01
```

--------------------------------

### Docker Compose Upgrade Commands

Source: https://glitchtip.com/documentation/install

Commands to pull the latest Docker image and restart GlitchTip services for an upgrade. Database migrations are handled automatically.

```bash
docker compose pull
docker compose stop

docker compose up -d
```

--------------------------------

### Upload Debug Files

Source: https://glitchtip.com/documentation/cli

Uploads debug symbol files (dSYM, PDB, ELF) for native applications to GlitchTip.

```bash
glitchtip-cli debug-files upload ./build --org my-org --project my-project
```

--------------------------------

### Manage GlitchTip Issues

Source: https://glitchtip.com/documentation/cli

Commands for managing issues within GlitchTip, including listing, resolving, muting, and unresolving issues by their ID.

```bash
# List issues
glitichtip-cli issues list --org my-org --project my-project

# Resolve issues
glitichtip-cli issues resolve --id 123

# Mute issues
glitichtip-cli issues mute --id 456

# Unresolve issues
glitichtip-cli issues unresolve --id 789
```

--------------------------------

### Configure Apache2 for GlitchTip

Source: https://glitchtip.com/documentation/install

This Apache2 configuration sets up proxying for GlitchTip, forwarding requests to localhost:8000 and preserving host information. Ensure the necessary mods (header, proxy, proxy_http) are enabled.

```apache
ProxyPreserveHost On
ProxyPass / http://localhost:8000/
ProxyPassReverse / http://localhost:8000/
RequestHeader set "X-Forwarded-Proto" expr=%{REQUEST_SCHEME}
RequestHeader set "X-Forwarded-SSL" expr=%{HTTPS}
```

--------------------------------

### Set DuckDB Temporary Directory

Source: https://glitchtip.com/documentation/install

Specify a writable directory for DuckDB to use for spilling query data to disk when the memory limit is reached. Ensure this directory exists and is writable by the GlitchTip process.

```bash
DUCKDB_TEMP_DIRECTORY=/data/duckdb_tmp
```

--------------------------------

### Configure Error Event Sampling Rate

Source: https://glitchtip.com/documentation/frequently-asked-questions

Set the `sampleRate` option to control the percentage of error events sent to GlitchTip. Useful when unable to resolve all errors immediately.

```javascript
sampleRate: 0.5
```

--------------------------------

### Configure Database Connection Pool Size

Source: https://glitchtip.com/documentation/install

Set the maximum number of concurrent connections to the PostgreSQL database. It's often recommended to match this with VTASKS_CONCURRENCY, but be mindful of your database's connection limit.

```bash
DATABASE_POOL_MAX_SIZE=40
```

--------------------------------

### Enable HTTP Strict Transport Security (HSTS)

Source: https://glitchtip.com/documentation/install

Set a non-zero value in seconds to enforce HTTPS connections for all future requests from browsers. This enhances security by preventing downgrade attacks.

```bash
SECURE_HSTS_SECONDS=31536000
```

--------------------------------

### Add GlitchTip MCP Server via Claude CLI

Source: https://glitchtip.com/documentation/mcp

Add GlitchTip as an MCP server using the Claude command-line interface. This command specifies the transport protocol and the GlitchTip MCP endpoint URL. Authentication is handled during the first connection.

```bash
claude mcp add --transport http glitchtip https://your-glitchtip.example.com/mcp
```

--------------------------------

### Configure Granian Web Workers

Source: https://glitchtip.com/documentation/install

Set the number of Granian web server workers. This setting is primarily for scaling vertically. For horizontal scaling, consider adjusting other parameters and using multiple instances.

```bash
GRANIAN_WORKERS=4
```

--------------------------------

### Configure OpenID Connect SSO Settings

Source: https://glitchtip.com/documentation/install

This JSON configuration is used within the Django Admin's Social Application settings for OpenID Connect based Single Sign-On. The 'server_url' is mandatory and points to the identity provider's OpenID configuration endpoint.

```json
{
  "server_url": "https://my-idp.example.com/auth/realms/my-realm/.well-known/openid-configuration"
}
```

--------------------------------

### Configure S3 Cold Storage Bucket

Source: https://glitchtip.com/documentation/install

Specify the S3 bucket name for storing archived data. If AWS_STORAGE_BUCKET_NAME is set, it will be used as a default. Files will be stored under the 'cold_storage/' prefix.

```bash
GLITCHTIP_COLD_STORAGE_BUCKET=your-s3-bucket-name
```

--------------------------------

### Grant Web User Database Permissions

Source: https://glitchtip.com/documentation/install

Assigns read/write permissions to the 'glitchtip_app' role for existing and future tables, sequences, and functions in the public schema. This is suitable for the web service.

```sql
CREATE ROLE glitchtip_app WITH LOGIN PASSWORD 'replace_with_app_password';
GRANT CONNECT ON DATABASE your_database_name TO glitchtip_app;
GRANT USAGE ON SCHEMA public TO glitchtip_app;

-- Grant read/write permissions on all EXISTING tables, sequences, and functions.
GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO glitchtip_app;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO glitchtip_app;
GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA public TO glitchtip_app;

-- Grant read/write permissions on all FUTURE tables, sequences, and functions.
ALTER DEFAULT PRIVILEGES IN SCHEMA public
   GRANT SELECT, INSERT, UPDATE, DELETE ON TABLES TO glitchtip_app;
ALTER DEFAULT PRIVILEGES IN SCHEMA public
   GRANT USAGE, SELECT ON SEQUENCES TO glitchtip_app;
ALTER DEFAULT PRIVILEGES IN SCHEMA public
   GRANT EXECUTE ON FUNCTIONS TO glitchtip_app;
```

--------------------------------

### Set DuckDB Memory Limit

Source: https://glitchtip.com/documentation/install

Configure the memory limit for DuckDB queries to prevent OutOfMemory errors during archival. Setting this to an empty string disables the limit, allowing DuckDB to use available memory or spill to disk.

```bash
DUCKDB_MEMORY_LIMIT=256MB
```

--------------------------------

### Configure Sentinel Service Name

Source: https://glitchtip.com/documentation/install

Specify the service name for your Sentinel topology. This is used by the cache client to discover the master instance.

```bash
CACHE_SENTINEL_SERVICE_NAME=mymaster
```

--------------------------------

### Configure VTASKS Concurrency

Source: https://glitchtip.com/documentation/install

Adjust the number of concurrent asyncio background tasks for the django-vtasks worker. A higher value can improve throughput but may increase resource consumption.

```bash
VTASKS_CONCURRENCY=40
```

--------------------------------

### Configure Sentinel Database Number

Source: https://glitchtip.com/documentation/install

Set the database number to be used with the Sentinel configuration. This specifies which database on the master instance the cache client should connect to.

```bash
CACHE_SENTINEL_DB=0
```

--------------------------------

### Include Subdomains in HSTS

Source: https://glitchtip.com/documentation/install

When true, the HSTS policy will also apply to all subdomains of the current domain. Ensure all subdomains are properly configured for HTTPS before enabling this.

```bash
SECURE_HSTS_INCLUDE_SUBDOMAINS=true
```

--------------------------------

### Disable Cold Storage Cleanup

Source: https://glitchtip.com/documentation/install

Set this to False if you are managing cold storage file cleanup using S3 lifecycle policies or other external mechanisms. By default, GlitchTip automatically deletes expired cold storage files.

```bash
GLITCHTIP_COLD_STORAGE_CLEANUP_ENABLED=false
```

--------------------------------

### Grant Maintainer Database Permissions

Source: https://glitchtip.com/documentation/install

Assigns full permissions to the 'glitchtip_maintainer' role for existing and future tables, sequences, and functions. This role is intended for migrate/worker services that require broader schema management.

```sql
CREATE ROLE glitchtip_maintainer WITH LOGIN PASSWORD 'replace_with_maintainer_password';
GRANT CONNECT ON DATABASE your_database_name TO glitchtip_maintainer;
GRANT CREATE, USAGE ON SCHEMA public TO glitchtip_maintainer;

-- Grant full permissions for all existing tables, sequences, and functions.
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO glitchtip_maintainer;
GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA public TO glitchtip_maintainer;
GRANT ALL PRIVILEGES ON ALL FUNCTIONS IN SCHEMA public TO glitchtip_maintainer;

-- Grant full permissions for any new tables this role creates in the future.
ALTER DEFAULT PRIVILEGES FOR ROLE glitchtip_maintainer IN SCHEMA public
   GRANT ALL PRIVILEGES ON TABLES TO glitchtip_maintainer;
ALTER DEFAULT PRIVILEGES FOR ROLE glitchtip_maintainer IN SCHEMA public
   GRANT ALL PRIVILEGES ON SEQUENCES TO glitchtip_maintainer;
ALTER DEFAULT PRIVILEGES FOR ROLE glitchtip_maintainer IN SCHEMA public
   GRANT ALL PRIVILEGES ON FUNCTIONS TO glitchtip_maintainer;
```

--------------------------------

### Disable Log Ingestion

Source: https://glitchtip.com/documentation/logs

Set this environment variable to disable log ingestion. When disabled, log events are silently dropped.

```bash
GLITCHTIP_ENABLE_LOGS=False
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.