---
title: "Troubleshoot failed download requests with client error logs"
description: "We have updated Client Logs to capture error events, ensuring platform engineering teams have the critical information needed to troubleshoot issues on behalf of their teams."
canonical_url: "https://cloudsmith.com/changelog/troubleshoot-failed-download-requests-with-client-error-logs"
last_updated: "2025-12-05T19:48:52.391Z"
---
# Troubleshoot failed download requests with client error logs

We have updated **Client Logs** to capture error events, giving platform engineering teams the critical information needed to troubleshoot build issues on behalf of their teams.

Previously, our [Client Logs](https://docs.cloudsmith.com/logs-and-observability/client-logs) only displayed successful activity, so it could be challenging to manually piece together context when errors occurred. With this update, Cloudsmith provides more comprehensive observability into your software supply chain. By surfacing requests that result in an error alongside successful ones, your team gains a centralized view of system health, making it easier to spot trends and resolve issues quickly.

```json
{
  "_key": "1997dffd738b",
  "_type": "image",
  "alt": "Client Logs now include error events in the Cloudsmith web app",
  "asset": {
    "_createdAt": "2025-12-05T19:51:20Z",
    "_id": "image-62237a9ff288cd725f6be0a96f01bb3cb4fe0fdf-2312x1616-png",
    "_rev": "yWHfvCutmAToEjAy7SInMl",
    "_type": "sanity.imageAsset",
    "_updatedAt": "2025-12-05T19:51:20Z",
    "assetId": "62237a9ff288cd725f6be0a96f01bb3cb4fe0fdf",
    "extension": "png",
    "metadata": {
      "_type": "sanity.imageMetadata",
      "blurHash": "V9SY~#-;t8?bIUS*t7WBRjxukDj]M{j[WV~qIVM|WBWC",
      "dimensions": {
        "_type": "sanity.imageDimensions",
        "aspectRatio": 1.4306930693069306,
        "height": 1616,
        "width": 2312
      },
      "hasAlpha": true,
      "isOpaque": true,
      "lqip": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAOCAYAAAAvxDzwAAAACXBIWXMAABYlAAAWJQFJUiTwAAACF0lEQVR4nGVTa2/bMAz0//9l+zhgW1ug3drm3TixY0uiSD18A2kn6boPB0kwfbo7Uk03EgbPGEngOSOmCs7THeW6B6TM4FQRpRgkV/vnNBDe9mc0QxA4muFjAimpFidFva2SJyQjnIyQpFh94Gz7kRI6R2jGEOGJQZwQRckyWJH+heSCtEDPISYMPhpClNv/jQsETxEpFZRarbgfPfZtj+2xw+HUo+0GtP2AY3fBR3fB7tjhfX/C267F+77F+nDCru1wHhyayAKWhJwLqhJKwq7t8fi6xa/fazy9bvCy2hueVwc8rw94fN3gx/MKP1/WePizmevetth8dGhEktlQslKq7TWGth/Rni84nnocTeFoCnoX0I0ep4tDN3jD+eJwHrzZbygyJGWzWxfkUsGaSSQQBRBFMAtSzqh1wjQBddJ1snMuc7aSymw5fiq2glwQo8CThw8OIQTEqDmn+WIlXIhLnW7NUmGNZkYsEMkoZSbUj6o8kJINCMGDmVEsmkXZTWE1AdpUnY4m8kKYMmqpd4XMICMczbZanhu3WP60Zsu+zpZt5m5dvlsmZjhycGE0y5qjNlAbN/1nud4zVGWi2ZQ7ocpXyyN5jMHBeY8QyFQq4dcMc57nl6KgsVfwhVALtFGOA1wMCKTdjubkK+FVgD6G1b5FE0WQlGwZgesYsAhiVKseRAQRsayuRFfoWS9a7Y749v0BfwEh+kDqRYwdXQAAAABJRU5ErkJggg==",
      "palette": {
        "_type": "sanity.imagePalette",
        "darkMuted": {
          "_type": "sanity.imagePaletteSwatch",
          "background": "#284454",
          "foreground": "#fff",
          "population": 0,
          "title": "#fff"
        },
        "darkVibrant": {
          "_type": "sanity.imagePaletteSwatch",
          "background": "#1e364c",
          "foreground": "#fff",
          "population": 0.01,
          "title": "#fff"
        },
        "dominant": {
          "_type": "sanity.imagePaletteSwatch",
          "background": "#a8beca",
          "foreground": "#000",
          "population": 0.31,
          "title": "#fff"
        },
        "lightMuted": {
          "_type": "sanity.imagePaletteSwatch",
          "background": "#a8beca",
          "foreground": "#000",
          "population": 0.31,
          "title": "#fff"
        },
        "lightVibrant": {
          "_type": "sanity.imagePaletteSwatch",
          "background": "#a4d7bd",
          "foreground": "#000",
          "population": 0.02,
          "title": "#fff"
        },
        "muted": {
          "_type": "sanity.imagePaletteSwatch",
          "background": "#6c8ca4",
          "foreground": "#fff",
          "population": 0,
          "title": "#fff"
        },
        "vibrant": {
          "_type": "sanity.imagePaletteSwatch",
          "background": "#4881b6",
          "foreground": "#fff",
          "population": 0,
          "title": "#fff"
        }
      }
    },
    "mimeType": "image/png",
    "originalFilename": "errors_cropped.png",
    "path": "images/rafvlnhi/production/62237a9ff288cd725f6be0a96f01bb3cb4fe0fdf-2312x1616.png",
    "sha1hash": "62237a9ff288cd725f6be0a96f01bb3cb4fe0fdf",
    "size": 485226,
    "uploadId": "TdEriv0rVygPYa2mlY5aizk2FgQTuNYy",
    "url": "https://cdn.sanity.io/images/rafvlnhi/production/62237a9ff288cd725f6be0a96f01bb3cb4fe0fdf-2312x1616.png"
  },
  "caption": "Client Logs now include error events in the Cloudsmith web app",
  "link": {
    "_type": "link",
    "href": null,
    "openInNewTab": false
  },
  "markDefs": null
}
```

## What’s new

- **Error visibility**: Logs now capture status codes (`4xx` and `5xx`) for failed download requests.
- **Rich context**: In addition to the status code, logs capture key request details including method, path, timestamp, user agent, IP address, and location.

This feature is available now in the Cloudsmith web app for customers using [**custom domains**](https://docs.cloudsmith.com/workspaces/custom-domains). Error logs will also soon be available in your Cloudsmith client log exports; please [contact us](https://cloudsmith.com/company/contact-us) for details.