---
title: Memantau dan memecahkan masalah worker self-hosted
url: https://platform.claude.com/docs/id/managed-agents/self-hosted-sandboxes-operations
description: Baca kedalaman antrean, hentikan sesi dan worker tanpa kehilangan pekerjaan, dan perbaiki kegagalan umum sandbox self-hosted.
featureMetadata:
  topic:
    title: Managed Agents
    url: https://platform.claude.com/docs/en/managed-agents/overview
  status: beta
  betaHeader: managed-agents-2026-04-01
  zdr:
    eligibility: not-eligible
    note: Tidak memiliki kelayakan ZDR, kecuali untuk Managed Agents yang di-host sendiri. Sesi adalah sumber daya stateful; transkrip tetap tersimpan hingga Anda menghapusnya.
  supportedModels:
    - claude-fable-5-2
    - claude-mythos-5-2
    - claude-fable-5-1
    - claude-mythos-5-1
    - claude-fable-5
    - claude-mythos-5
    - claude-mythos-preview
    - claude-opus-5-5
    - claude-opus-5
    - claude-sonnet-5-5
    - claude-sonnet-5
    - claude-haiku-5-5
    - claude-haiku-4-5-20251001
    - claude-opus-4-8
    - claude-opus-4-7
    - claude-opus-4-6
    - claude-sonnet-4-6
    - claude-opus-4-5-20251101
    - claude-sonnet-4-5-20250929
  supportedPlatforms:
    Claude API: beta
    Claude Platform on AWS: beta
    Claude Models on Google Cloud (Anthropic managed):
      availability: beta
      note: Anda menulis worker Anda sendiri, yang memanggil endpoint Environments Work.
---

Panggilan statistik antrean dan penghentian di halaman ini dijalankan dari alat pemantauan atau operasional Anda, diautentikasi dengan kunci API organisasi Anda. Helper worker menangani loop klaim dan keep-alive, sehingga Anda tidak memanggil endpoint tersebut secara langsung.

<Warning>
  Endpoint statistik antrean dan penghentian menerima kunci API organisasi Anda atau kunci lingkungan. Panggil endpoint ini dari luar host worker dengan kunci API organisasi Anda. Menetapkan `ANTHROPIC_API_KEY` pada host worker akan mengekspos kredensial berlingkup organisasi ke panggilan alat agen.
</Warning>

## Membaca kedalaman antrean

`GET /v1/environments/{environment_id}/work/stats` (python, typescript, ruby: `client.beta.environments.work.stats()`; go, csharp: `client.Beta.Environments.Work.Stats()`; java: `client.beta().environments().work().stats()`; php: `$client->beta->environments->work->stats()`; cli: `ant beta:environments:work stats`) mengembalikan status antrean untuk sebuah environment:

| Field | Arti | Gunakan untuk |
| ----- | ----- | ----- |
| `depth` (csharp, go: `Depth`) | Item yang menunggu untuk diklaim. | Menskalakan armada worker Anda atau memberi peringatan saat terjadi backlog. |
| `pending` (csharp, go: `Pending`) | Item yang telah diklaim oleh worker tetapi belum di-acknowledge. Helper worker melakukan acknowledge pada setiap item sebelum memprosesnya, sehingga nilai ini tetap mendekati nol dalam operasi normal. | Mendeteksi worker yang macet antara mengklaim dan melakukan acknowledge: beri peringatan pada nilai bukan nol yang bertahan lama. |
| `oldest_queued_at` (java, php: `oldestQueuedAt`; csharp, go: `OldestQueuedAt`) | Timestamp item tertua yang masih berada di antrean, baik yang menunggu untuk diklaim maupun yang sudah diklaim tetapi belum di-acknowledge. `null` (python: `None`; ruby: `nil`; java: `Optional.empty()`; go: `""`) jika tidak ada item seperti itu. | Melihat berapa lama item tertua telah menunggu. |
| `workers_polling` (java, php: `workersPolling`; csharp, go: `WorkersPolling`) | Worker yang telah melakukan polling dalam 30 detik terakhir. | Memberi peringatan terkait liveness. |

<CodeGroup>
  ```bash cURL
  curl -sS "https://api.anthropic.com/v1/environments/$ANTHROPIC_ENVIRONMENT_ID/work/stats" \
    -H "x-api-key: $ANTHROPIC_API_KEY" \
    -H "anthropic-beta: managed-agents-2026-04-01" \
    -H "anthropic-version: 2026-10-21"
  ```

  ```bash CLI
  ant beta:environments:work stats --environment-id "$ANTHROPIC_ENVIRONMENT_ID"
  ```

  ```python Python
  import os

  import anthropic

  client = anthropic.Anthropic()

  stats = client.beta.environments.work.stats(os.environ["ANTHROPIC_ENVIRONMENT_ID"])
  print(f"depth={stats.depth} pending={stats.pending}")
  ```

  ```typescript TypeScript
  import Anthropic from "@anthropic-ai/sdk";

  const client = new Anthropic();

  const stats = await client.beta.environments.work.stats(process.env.ANTHROPIC_ENVIRONMENT_ID!);

  console.log(`depth=${stats.depth} pending=${stats.pending}`);
  ```

  ```csharp C#
  using Anthropic;

  var client = new AnthropicClient();

  var environmentId = Environment.GetEnvironmentVariable("ANTHROPIC_ENVIRONMENT_ID")!;

  var stats = await client.Beta.Environments.Work.Stats(environmentId);

  Console.WriteLine($"depth={stats.Depth} pending={stats.Pending}");
  ```

  ```go Go
  package main

  import (
  	"context"
  	"fmt"
  	"os"

  	"github.com/anthropics/anthropic-sdk-go/v2"
  )

  func main() {
  	client := anthropic.NewClient()
  	environmentID := os.Getenv("ANTHROPIC_ENVIRONMENT_ID")

  	stats, err := client.Beta.Environments.Work.Stats(
  		context.Background(),
  		environmentID,
  		anthropic.BetaEnvironmentWorkStatsParams{},
  	)
  	if err != nil {
  		panic(err)
  	}

  	fmt.Printf("depth=%d pending=%d\n", stats.Depth, stats.Pending)
  }
  ```

  ```java Java
  import com.anthropic.client.AnthropicClient;
  import com.anthropic.client.okhttp.AnthropicOkHttpClient;
  import com.anthropic.models.beta.environments.work.BetaSelfHostedWorkQueueStats;

  void main() {
      AnthropicClient client = AnthropicOkHttpClient.fromEnv();

      BetaSelfHostedWorkQueueStats stats = client.beta()
          .environments()
          .work()
          .stats(System.getenv("ANTHROPIC_ENVIRONMENT_ID"));

      IO.println("depth=" + stats.depth() + " pending=" + stats.pending());
  }
  ```

  ```php PHP
  <?php

  use Anthropic\Client;

  $client = new Client();

  $stats = $client->beta->environments->work->stats(getenv('ANTHROPIC_ENVIRONMENT_ID'));

  printf("depth=%d pending=%d\n", $stats->depth, $stats->pending);
  ```

  ```ruby Ruby
  require "anthropic"

  client = Anthropic::Client.new

  stats = client.beta.environments.work.stats(ENV.fetch("ANTHROPIC_ENVIRONMENT_ID"))

  puts "depth=#{stats.depth} pending=#{stats.pending}"
  ```
</CodeGroup>

```json
{
  "type": "work_queue_stats",
  "depth": 0,
  "pending": 0,
  "oldest_queued_at": null,
  "workers_polling": 0
}
```

## Menghentikan sesi dengan baik

Gunakan `POST /v1/environments/{environment_id}/work/{work_id}/stop` (python, typescript, ruby: `client.beta.environments.work.stop()`; go, csharp: `client.Beta.Environments.Work.Stop()`; java: `client.beta().environments().work().stop()`; php: `$client->beta->environments->work->stop()`; cli: `ant beta:environments:work stop`) untuk meminta worker yang menangani sesi tertentu agar mematikannya.

Secara default, item pekerjaan berpindah ke `stopping`. Worker mendeteksi hal ini pada heartbeat lease berikutnya, membatalkan panggilan alat sesi yang sedang berjalan, dan mengonfirmasi penghentian. Item pekerjaan kemudian menjadi `stopped`. Worker SDK Python justru membiarkan panggilan alat yang sedang berjalan selesai terlebih dahulu, yang dapat memakan waktu hingga 2,5 menit.

Berikan `force: true` (python: `force=True`; csharp: `Force = true`; go: `BetaSelfHostedWorkStopRequest: anthropic.BetaSelfHostedWorkStopRequestParam{Force: anthropic.Bool(true)}`; java: `.force(true)`; cli: `--force`) untuk menandai item pekerjaan sebagai `stopped` secara langsung alih-alih menunggu konfirmasi dari worker. Penghentian paksa tidak membuat panggilan alat yang sedang berjalan berakhir lebih cepat, karena worker tetap mendeteksi penghentian pada heartbeat berikutnya.

Karena panggilan ini dijalankan dari alat operasional Anda, bukan dari host worker, `ANTHROPIC_WORK_ID` tidak ditetapkan secara otomatis. Tetapkan ke ID item pekerjaan target sebelum menjalankan contoh berikut. Untuk menemukan ID item pekerjaan, panggil [Daftar Item Pekerjaan](https://platform.claude.com/docs/id/api/beta/environments/work/list) dengan kunci lingkungan, yang dikirim sebagai `Authorization: Bearer $ANTHROPIC_ENVIRONMENT_KEY`. Endpoint tersebut menolak kunci API organisasi Anda.

<CodeGroup>
  ```bash cURL
  curl -sS "https://api.anthropic.com/v1/environments/$ANTHROPIC_ENVIRONMENT_ID/work/$ANTHROPIC_WORK_ID/stop" \
    -H "x-api-key: $ANTHROPIC_API_KEY" \
    -H "anthropic-beta: managed-agents-2026-04-01" \
    -H "anthropic-version: 2026-10-21" \
    -H "content-type: application/json" \
    -d '{}'
  ```

  ```bash CLI
  ant beta:environments:work stop \
    --environment-id "$ANTHROPIC_ENVIRONMENT_ID" \
    --work-id "$ANTHROPIC_WORK_ID"
  ```

  ```python Python
  import os

  import anthropic

  client = anthropic.Anthropic()

  work = client.beta.environments.work.stop(
      os.environ["ANTHROPIC_WORK_ID"],
      environment_id=os.environ["ANTHROPIC_ENVIRONMENT_ID"],
  )
  print(work.state)
  ```

  ```typescript TypeScript
  import Anthropic from "@anthropic-ai/sdk";

  const client = new Anthropic();

  const work = await client.beta.environments.work.stop(process.env.ANTHROPIC_WORK_ID!, {
    environment_id: process.env.ANTHROPIC_ENVIRONMENT_ID!
  });

  console.log(work.state);
  ```

  ```csharp C#
  using Anthropic;

  var client = new AnthropicClient();

  var work = await client.Beta.Environments.Work.Stop(
      Environment.GetEnvironmentVariable("ANTHROPIC_WORK_ID")!,
      new()
      {
          EnvironmentID = Environment.GetEnvironmentVariable("ANTHROPIC_ENVIRONMENT_ID")!
      }
  );

  Console.WriteLine(work.State);
  ```

  ```go Go
  package main

  import (
  	"context"
  	"fmt"
  	"os"

  	"github.com/anthropics/anthropic-sdk-go/v2"
  )

  func main() {
  	client := anthropic.NewClient()

  	work, err := client.Beta.Environments.Work.Stop(
  		context.Background(),
  		os.Getenv("ANTHROPIC_WORK_ID"),
  		anthropic.BetaEnvironmentWorkStopParams{
  			EnvironmentID: os.Getenv("ANTHROPIC_ENVIRONMENT_ID"),
  		},
  	)
  	if err != nil {
  		panic(err)
  	}
  	fmt.Println(work.State)
  }
  ```

  ```java Java
  import com.anthropic.client.AnthropicClient;
  import com.anthropic.client.okhttp.AnthropicOkHttpClient;
  import com.anthropic.models.beta.environments.work.BetaSelfHostedWork;
  import com.anthropic.models.beta.environments.work.BetaSelfHostedWorkStopRequest;
  import com.anthropic.models.beta.environments.work.WorkStopParams;

  void main() {
      AnthropicClient client = AnthropicOkHttpClient.fromEnv();

      BetaSelfHostedWork work = client.beta().environments().work().stop(
          WorkStopParams.builder()
              .environmentId(System.getenv("ANTHROPIC_ENVIRONMENT_ID"))
              .workId(System.getenv("ANTHROPIC_WORK_ID"))
              .betaSelfHostedWorkStopRequest(BetaSelfHostedWorkStopRequest.builder().build())
              .build()
      );

      IO.println(work.state());
  }
  ```

  ```php PHP
  <?php

  use Anthropic\Client;

  $client = new Client();

  $work = $client->beta->environments->work->stop(
      getenv('ANTHROPIC_WORK_ID'),
      environmentID: getenv('ANTHROPIC_ENVIRONMENT_ID'),
  );

  echo $work->state . "\n";
  ```

  ```ruby Ruby
  require "anthropic"

  client = Anthropic::Client.new

  work = client.beta.environments.work.stop(
    ENV.fetch("ANTHROPIC_WORK_ID"),
    environment_id: ENV.fetch("ANTHROPIC_ENVIRONMENT_ID")
  )

  puts work.state
  ```
</CodeGroup>

## Menghentikan worker dengan baik

Worker yang dibatalkan saat sesi sedang berjalan akan mematikan sesi tersebut sebelum keluar, sama seperti saat Anda [menghentikan sesi](https://platform.claude.com/docs/id/managed-agents/self-hosted-sandboxes-operations#stop-a-session-gracefully). Jika sesi memiliki [memory store](https://platform.claude.com/docs/id/managed-agents/self-hosted-sandboxes-memory) yang terpasang, worker tetap mengunggah file baru dan file yang berubah serta menghapus direktori store. Worker tidak mengirimkan penghapusan, sehingga memori yang dihapus oleh agen tetap berada di store kecuali sinkronisasi sebelumnya sudah menghapusnya dari store.

Proses yang di-kill tidak menjalankan teardown. Untuk menghentikan worker dengan bersih:

1. **Pastikan SIGTERM dan SIGINT membatalkan worker.** Caranya bergantung pada worker:

   | Worker | Yang harus dilakukan |
   | ----- | ----- |
   | CLI `ant` | Tidak ada. CLI menangani kedua sinyal itu sendiri: CLI membatalkan panggilan alat yang sedang berjalan, mengirimkan hasil error-nya, dan menandai item pekerjaan sebagai `stopped`. |
   | Worker SDK yang merupakan prosesnya sendiri | `EnvironmentWorker` tidak memasang handler sinyal. Batalkan worker dari handler sinyal, seperti yang dilakukan contoh worker mandiri. |
   | Worker SDK di dalam server webhook | Batalkan worker dari hook shutdown milik server itu sendiri, seperti yang dilakukan contoh webhook. Worker tidak boleh mengambil alih sinyal server. |

2. **Hentikan worker dengan SIGTERM, dan beri waktu untuk selesai sebelum penghentian paksa apa pun.** Worker memerlukan waktu untuk mengakhiri panggilan alat yang sedang berjalan dan mengunggah file yang berubah ke memory store. Docker mengirim SIGKILL 10 detik setelah sinyal stop secara default. Naikkan batas tersebut dengan `--stop-timeout 60` (python: `--stop-timeout 210`) pada `docker run`, atau tetapkan masa tenggang penghentian dari orchestrator Anda ke jumlah detik yang sama.

Jika worker di-kill sebelum teardown-nya berjalan, setiap suntingan memori yang belum tersinkronisasi akan hilang. Pada host yang berumur panjang, hapus juga direktori store sisa di bawah `/mnt/memory/` sebelum sesi berikutnya yang melampirkan store tersebut. Sandbox yang melayani satu sesi lalu dibuang tidak memerlukan pembersihan.

## Pemecahan masalah

### Worker tidak terhubung

Jika `workers_polling` (java, php: `workersPolling`; csharp, go: `WorkersPolling`) tetap bernilai 0, worker tidak menjangkau antrean. Pastikan `ANTHROPIC_ENVIRONMENT_KEY` dan `ANTHROPIC_ENVIRONMENT_ID` telah ditetapkan pada host worker.

### Sesi tetap dalam antrean

Tidak ada worker yang mengklaim pekerjaan. Sesi yang berada dalam antrean akan menunggu alih-alih gagal. Periksa `workers_polling` (java, php: `workersPolling`; csharp, go: `WorkersPolling`) dan `depth` (csharp, go: `Depth`) di [Membaca kedalaman antrean](https://platform.claude.com/docs/id/managed-agents/self-hosted-sandboxes-operations#read-queue-depth).

### Memory store gagal di-mount atau disinkronkan

Tempat kegagalan memory store muncul bergantung pada jenisnya:

* **Kegagalan mount:** Jika worker tidak dapat me-mount memory store saat mengklaim sesi, worker mencatat kegagalan tersebut di log-nya dan menggagalkan item pekerjaan. Sesi tidak memancarkan event error dan tetap idle.
* **Kegagalan sinkronisasi:** Worker mencatat kegagalan tersebut di log-nya dan tidak melaporkannya ke sesi.
* **Penulisan yang ditolak ke store read-only:** Agen menerima error alat. Lihat [Store read-only dan konflik](https://platform.claude.com/docs/id/managed-agents/self-hosted-sandboxes-memory#read-only-stores-and-conflicts).

| Gejala | Penyebab | Perbaikan |
| ----- | ----- | ----- |
| Log worker berisi `the work item carried no sessions token` (di Go, error `ErrSessionMemoryNoToken`) dan item pekerjaan gagal. | `secret` (csharp, go: `Secret`) per sesi dari item pekerjaan tidak sampai ke worker. Entah kode Anda tidak meneruskannya, atau memory store pada sandbox self-hosted tidak diaktifkan untuk organisasi Anda. | [Meneruskan secret item pekerjaan](https://platform.claude.com/docs/id/managed-agents/self-hosted-sandboxes-per-session#forward-the-work-items-secret). Jika worker melakukan polling dan menjalankan sesi dalam satu proses dan masih mencatat ini, hubungi dukungan. |
| Log worker berisi `something already exists at the memory store's path`. | Sesi lain pada “filesystem” (sistem file) yang sama sedang menggunakan path tersebut. Atau worker dari sesi sebelumnya di-kill sebelum teardown-nya berjalan, sehingga direktori tersebut tertinggal. | Periksa apakah masih ada worker yang menjalankan sesi yang menggunakan path tersebut. Jika ada, jangan hapus direktori tersebut: worker akan menghapusnya saat selesai menangani sesi. Jika tidak ada, hapus direktori yang disebutkan oleh baris log. Suntingan di dalamnya yang belum tersinkronisasi akan hilang. Untuk menjalankan dua sesi seperti itu sekaligus, lihat [Mengisolasi sesi yang berbagi store](https://platform.claude.com/docs/id/managed-agents/self-hosted-sandboxes-memory#isolate-sessions-that-share-a-store). |
| Log worker berisi `cannot create the memory store's folder` dan `the worker host must make this mount path writable`. | Pengguna yang menjalankan worker tidak dapat membuat direktori di bawah `/mnt/memory`. | Buat `/mnt/memory` dan `chown` ke pengguna tersebut. Lihat [Menyiapkan host](https://platform.claude.com/docs/id/managed-agents/self-hosted-sandboxes-memory#prepare-the-host). Di macOS, ikuti [Menyiapkan host macOS](https://platform.claude.com/docs/id/managed-agents/self-hosted-sandboxes-memory#prepare-a-macos-host) sebagai gantinya. |
| Sesi berada dalam status `idle` dengan alasan berhenti `requires_action` dan tanpa event error tak lama setelah worker mengklaimnya. | Worker menggagalkan item pekerjaan karena tidak dapat me-mount memory store, karena salah satu alasan sebelumnya. | Perbaiki penyebabnya di host, lalu kirim event [`user.interrupt`](https://platform.claude.com/docs/id/managed-agents/events-and-streaming#interrupt-the-agent). Pekerjaan sesi dimasukkan kembali ke antrean, dan worker berikutnya yang mengklaimnya akan mencoba mount lagi. |

### Panggilan alat kustom tidak pernah kembali

Jika sesi berada dalam keadaan dijeda dengan alasan berhenti `requires_action`, tidak ada worker atau klien yang melayani alat tersebut. Lihat [Melayani alat kustom](https://platform.claude.com/docs/id/managed-agents/self-hosted-sandboxes-custom-tools#serve-a-custom-tool).

### Panggilan alat MCP yang dibungkus macet

Tanpa timeout pada klien MCP, panggilan yang macet ke [server MCP yang dibungkus](https://platform.claude.com/docs/id/managed-agents/self-hosted-sandboxes-custom-tools#wrap-an-mcp-server-as-custom-tools) baru menjadi hasil alat error ketika sebuah backstop terpicu:

| SDK | Pengaman terakhir | Terpicu setelah |
| ----- | ----- | ----- |
| Python | Batas panggilan alat milik worker itu sendiri | Sekitar 2,5 menit |
| TypeScript | Timeout permintaan default dari MCP SDK | Sekitar satu menit |
| Go | Worker membatalkan panggilan alat yang melampaui batas default-nya | 120 detik |
