---
title: Мониторинг и устранение неполадок самостоятельно размещаемых воркеров
url: https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-operations
description: Отслеживайте глубину очереди, останавливайте сеансы и воркеры без потери работы и устраняйте распространённые сбои самостоятельно размещаемых песочниц.
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: Не подпадает под ZDR, за исключением самостоятельно размещаемых Managed Agents. Сессии — это ресурсы с состоянием; их расшифровки хранятся, пока вы их не удалите.
  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: Вы пишете собственный воркер, который вызывает конечные точки Environments Work.
---

Вызовы получения статистики очереди и остановки на этой странице выполняются из ваших инструментов мониторинга или эксплуатации с аутентификацией по ключу API вашей организации. Вспомогательные средства воркера обрабатывают цикл получения задач и поддержания активности, поэтому вам не нужно вызывать эти конечные точки напрямую.

<Warning>
  Конечные точки статистики очереди и остановки принимают либо ключ API вашей организации, либо ключ среды. Вызывайте их извне хоста воркера с ключом API вашей организации. Установка `ANTHROPIC_API_KEY` на хосте воркера открывает учётные данные уровня организации для вызовов инструментов агента.
</Warning>

## Чтение глубины очереди

`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`) возвращает состояние очереди для среды:

| Поле | Значение | Для чего использовать |
| ----- | ----- | ----- |
| `depth` (csharp, go: `Depth`) | Элементы, ожидающие получения. | Масштабирование парка воркеров или оповещение о накоплении задач. |
| `pending` (csharp, go: `Pending`) | Элементы, полученные воркером, но ещё не подтверждённые. Вспомогательные средства воркера подтверждают каждый элемент перед его обработкой, поэтому при нормальной работе это значение остаётся близким к нулю. | Обнаружение воркера, зависшего между получением и подтверждением: настройте оповещение на устойчивое ненулевое значение. |
| `oldest_queued_at` (java, php: `oldestQueuedAt`; csharp, go: `OldestQueuedAt`) | Временная метка самого старого элемента, всё ещё находящегося в очереди: ожидающего получения либо полученного, но ещё не подтверждённого. `null` (python: `None`; ruby: `nil`; java: `Optional.empty()`; go: `""`), если такого элемента нет. | Узнать, как долго ждёт самый старый элемент. |
| `workers_polling` (java, php: `workersPolling`; csharp, go: `WorkersPolling`) | Воркеры, опрашивавшие очередь за последние 30 секунд. | Оповещение о работоспособности. |

<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
}
```

## Корректная остановка сеанса

Используйте `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`), чтобы попросить воркер, обрабатывающий конкретный сеанс, завершить его.

По умолчанию элемент работы переходит в состояние `stopping`. Воркер обнаруживает это при следующем «lease heartbeat» (контрольном сигнале аренды), отменяет выполняющийся вызов инструмента сеанса и подтверждает завершение. После этого элемент работы переходит в состояние `stopped`. Воркер на Python SDK вместо этого сначала позволяет выполняющемуся вызову инструмента завершиться, что может занять до 2,5 минуты.

Передайте `force: true` (python: `force=True`; csharp: `Force = true`; go: `BetaSelfHostedWorkStopRequest: anthropic.BetaSelfHostedWorkStopRequestParam{Force: anthropic.Bool(true)}`; java: `.force(true)`; cli: `--force`), чтобы немедленно пометить элемент работы как `stopped`, не дожидаясь подтверждения от воркера. Принудительная остановка не завершает выполняющийся вызов инструмента быстрее, поскольку воркер всё равно замечает остановку при следующем heartbeat-сигнале.

Поскольку эти вызовы выполняются из ваших инструментов эксплуатации, а не на хосте воркера, `ANTHROPIC_WORK_ID` не устанавливается автоматически. Перед запуском следующих примеров задайте в этой переменной ID целевого элемента работы. Чтобы найти ID элемента работы, вызовите конечную точку [Список рабочих элементов](https://platform.claude.com/docs/ru/api/beta/environments/work/list) с ключом среды, переданным как `Authorization: Bearer $ANTHROPIC_ENVIRONMENT_KEY`. Эта конечная точка отклоняет ключ API вашей организации.

<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>

## Корректная остановка воркеров

Воркер, отменённый во время выполнения сеанса, завершает этот сеанс перед выходом — так же, как при [остановке сеанса](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-operations#stop-a-session-gracefully). Если к сеансу подключены [хранилища памяти](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-memory), воркер всё равно загружает новые и изменённые файлы и удаляет каталоги хранилищ. Он не отправляет удаления, поэтому запись памяти, удалённая агентом, остаётся в хранилище, если только одна из предыдущих синхронизаций уже не удалила её из хранилища.

Процесс, который завершается принудительно, не выполняет никакой очистки. Чтобы корректно остановить воркер:

1. **Убедитесь, что SIGTERM и SIGINT отменяют воркер.** Способ зависит от воркера:

   | Воркер | Что сделать |
   | ----- | ----- |
   | CLI `ant` | Ничего. CLI сам обрабатывает оба сигнала: он отменяет выполняющийся вызов инструмента, отправляет результат с ошибкой и помечает элемент работы как `stopped`. |
   | Воркер SDK, работающий как отдельный процесс | `EnvironmentWorker` не устанавливает обработчики сигналов. Отменяйте воркер из обработчика сигнала, как это сделано в примерах автономных воркеров. |
   | Воркер SDK внутри сервера вебхуков | Отменяйте воркер из собственного хука завершения сервера, как это сделано в примерах с вебхуками. Воркер не должен перехватывать сигналы сервера. |

2. **Останавливайте воркер сигналом SIGTERM и дайте ему время завершить работу до любого принудительного завершения.** Воркеру нужно время, чтобы завершить выполняющийся вызов инструмента и выгрузить изменённые файлы в хранилище памяти. По умолчанию Docker отправляет SIGKILL через 10 секунд после сигнала остановки. Увеличьте этот лимит с помощью `--stop-timeout 60` (python: `--stop-timeout 210`) в `docker run` или задайте для периода ожидания завершения (termination grace period) вашего оркестратора такое же количество секунд.

Если воркер принудительно завершается до выполнения очистки, все несинхронизированные изменения памяти теряются. На долгоживущем хосте также удалите оставшийся каталог хранилища в `/mnt/memory/` перед следующим сеансом, который подключает это хранилище. Песочница, которая обслуживает один сеанс и затем удаляется, не требует очистки.

## Устранение неполадок

### Воркер не подключается

Если `workers_polling` (java, php: `workersPolling`; csharp, go: `WorkersPolling`) остаётся равным 0, воркер не достигает очереди. Убедитесь, что `ANTHROPIC_ENVIRONMENT_KEY` и `ANTHROPIC_ENVIRONMENT_ID` установлены на хосте воркера.

### Сеанс остаётся в очереди

Ни один воркер не получает работу. Сеанс в очереди ожидает, а не завершается с ошибкой. Проверьте `workers_polling` (java, php: `workersPolling`; csharp, go: `WorkersPolling`) и `depth` (csharp, go: `Depth`) в разделе [Чтение глубины очереди](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-operations#read-queue-depth).

### Хранилища памяти не монтируются или не синхронизируются

То, где проявляется сбой хранилища памяти, зависит от его типа:

* **Сбой монтирования:** если воркер не может смонтировать хранилище памяти при получении сеанса, он записывает сбой в журнал и завершает элемент работы с ошибкой. Сеанс не генерирует событие ошибки и остаётся в состоянии простоя.
* **Сбой синхронизации:** воркер записывает сбой в журнал и не сообщает о нём сеансу.
* **Отклонённая запись в хранилище только для чтения:** агент получает ошибку инструмента. См. [Хранилища только для чтения и конфликты](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-memory#read-only-stores-and-conflicts).

| Симптом | Причина | Решение |
| ----- | ----- | ----- |
| Журнал воркера содержит `the work item carried no sessions token` (в Go — ошибка `ErrSessionMemoryNoToken`), и элемент работы завершается с ошибкой. | `secret` (csharp, go: `Secret`) элемента работы для конкретного сеанса не дошёл до воркера. Либо ваш код не передал его, либо хранилища памяти в самостоятельно размещаемых песочницах не включены для вашей организации. | [Передайте секрет элемента работы](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-per-session#forward-the-work-items-secret). Если воркер опрашивает очередь и выполняет сеансы в одном процессе и всё равно записывает это в журнал, обратитесь в службу поддержки. |
| Журнал воркера содержит `something already exists at the memory store's path`. | Этот путь используется другим сеансом в той же файловой системе. Либо воркер предыдущего сеанса был принудительно завершён до выполнения очистки, и каталог остался. | Проверьте, выполняет ли какой-либо воркер всё ещё сеанс, использующий этот путь. Если да, не удаляйте каталог: воркер удалит его, когда закончит работу с сеансом. Если нет, удалите каталог, указанный в строке журнала. Несинхронизированные изменения в нём теряются. Чтобы запустить два таких сеанса одновременно, см. [Изоляция сеансов, использующих общее хранилище](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-memory#isolate-sessions-that-share-a-store). |
| Журнал воркера содержит `cannot create the memory store's folder` и `the worker host must make this mount path writable`. | Пользователь, от имени которого работает воркер, не может создавать каталоги в `/mnt/memory`. | Создайте `/mnt/memory` и выполните для него `chown` на этого пользователя. См. [Подготовка хоста](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-memory#prepare-the-host). В macOS вместо этого следуйте инструкциям из раздела [Подготовка хоста macOS](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-memory#prepare-a-macos-host). |
| Сеанс находится в состоянии `idle` с причиной остановки `requires_action` и без события ошибки вскоре после того, как воркер его получил. | Воркер завершил элемент работы с ошибкой, поскольку не смог смонтировать хранилище памяти по одной из указанных выше причин. | Устраните причину на хосте, затем отправьте событие [`user.interrupt`](https://platform.claude.com/docs/ru/managed-agents/events-and-streaming#interrupt-the-agent). Работа сеанса снова ставится в очередь, и следующий воркер, который её получит, повторит попытку монтирования. |

### Вызов пользовательского инструмента не возвращает результат

Если сеанс приостановлен с причиной остановки `requires_action`, ни один воркер или клиент не обслуживает этот инструмент. См. [Предоставление пользовательского инструмента](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-custom-tools#serve-a-custom-tool).

### Вызов обёрнутого инструмента MCP зависает

Без тайм-аута на клиенте MCP зависший вызов к [обёрнутому серверу MCP](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-custom-tools#wrap-an-mcp-server-as-custom-tools) превращается в результат инструмента с ошибкой только при срабатывании страховочного механизма:

| SDK | Страховочный механизм | Срабатывает через |
| ----- | ----- | ----- |
| Python | Собственный лимит воркера на вызов инструмента | Около 2,5 минуты |
| TypeScript | Тайм-аут запроса по умолчанию в MCP SDK | Около минуты |
| Go | Воркер отменяет вызов инструмента, превысивший лимит по умолчанию | 120 секунд |
