# upload-dsyms-github-action

**Repository Path**: mirrors_DataDog/upload-dsyms-github-action

## Basic Information

- **Project Name**: upload-dsyms-github-action
- **Description**: Github Action to upload iOS dSYM files using datadog-ci tool.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-12-23
- **Last Updated**: 2025-09-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Datadog Upload dSYMs Github Action
[![](https://github.com/DataDog/upload-dsyms-github-action/workflows/build-test/badge.svg)](https://github.com/Datadog/upload-dsyms-github-action/actions)

This Datadog GitHub Action uploads dSYM files to Datadog to symbolicate crash reports.
> This action runs only on `macos` environments.

## Setup

An [API key](https://app.datadoghq.com/organization-settings/api-keys) is required to upload dSYM files to Datadog. Store this key securely; for example, by using [GitHub encrypted secrets](https://docs.github.com/en/actions/security-guides/encrypted-secrets).


By default, the upload is sent to Datadog US ('datadoghq.com'). To configure this Action to use Datadog EU, set the `site` parameter to `datadoghq.eu`.

## Usage

```yml
name: Upload dSYM Files

jobs:
  build:
    runs-on: macos-latest

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Generate/Download dSYM Files
        uses: ./release.sh

      - name: Upload dSYMs to Datadog
        uses: DataDog/upload-dsyms-github-action@v1
        with:
          api_key: ${{ secrets.DATADOG_API_KEY }}
          site: datadoghq.com
          dsym_paths: |
            path/to/dsyms/folder
            path/to/zip/dsyms.zip
```

## Inputs

|name|type|requirement|description|
|---|---|---|---|
|`api_key`|string|required|Datadog API key. Use a secret storage to store this parameter.|
|`site`|string|optional|Datadog site region. Defaults to `datadoghq.com`; use `datadoghq.eu` for the EU.|
|`dsym_paths`|list|required|List of dSYM files path to upload. Supports paths to folders and/or to zip files.|
|`dry_run`|Boolean|optional|If `true`, the command runs without the final upload step. All other checks are performed.|