---
title: "Ice.Trace.*"
url: https://docs.zeroc.com/ice/3.8/property-reference/ice-trace-properties
docs_index: https://docs.zeroc.com/llms.txt
---

> For an index of every page, see [llms.txt](https://docs.zeroc.com/llms.txt).

# Ice.Trace.\*

Parts of this page are for some programming languages only, and name them. For one language's text alone, see [C++](https://docs.zeroc.com/ice/3.8/property-reference/ice-trace-properties/cpp.md), [C#](https://docs.zeroc.com/ice/3.8/property-reference/ice-trace-properties/csharp.md), [Java](https://docs.zeroc.com/ice/3.8/property-reference/ice-trace-properties/java.md), [JavaScript](https://docs.zeroc.com/ice/3.8/property-reference/ice-trace-properties/js.md), [MATLAB](https://docs.zeroc.com/ice/3.8/property-reference/ice-trace-properties/matlab.md), [PHP](https://docs.zeroc.com/ice/3.8/property-reference/ice-trace-properties/php.md), [Python](https://docs.zeroc.com/ice/3.8/property-reference/ice-trace-properties/python.md), [Ruby](https://docs.zeroc.com/ice/3.8/property-reference/ice-trace-properties/ruby.md), and [Swift](https://docs.zeroc.com/ice/3.8/property-reference/ice-trace-properties/swift.md).

> **C++, C#, Java, Python, Ruby, PHP, MATLAB, and Swift**
>
> ## Ice.Trace.Admin.Logger
>
> `Ice.Trace.Admin.Logger=num`
>
> Controls the trace level for the [Logger administrative facet](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/logger-facet.md).
>
> | Value | Description |
> | --- | --- |
> | `0` | No trace (default). |
> | `1` | Trace when a remote logger is attached or detached. |
> | `2` | Like `1`, but also trace the sending of log messages to remote loggers. |
>
> ## Ice.Trace.Admin.Properties
>
> `Ice.Trace.Admin.Properties=num`
>
> Controls the trace level for property updates made via the [Properties facet](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/properties-facet.md):
>
> | Value | Description |
> | --- | --- |
> | `0` | No property trace (default). |
> | `1` | Trace the names of added, changed, and removed properties. |
> | `2` | Like `1`, plus new values for added and changed properties and previous values for changed properties. |

## Ice.Trace.Dispatch

`Ice.Trace.Dispatch=num`

If `num` is greater than `0`, the logger middleware traces dispatches that complete successfully or return a user exception, and logs warnings for failed dispatches. In this case, [Ice.Warn.Dispatch](https://docs.zeroc.com/ice/3.8/property-reference/ice-warn-properties.md) does not control the middleware's logging. Otherwise, `Ice.Warn.Dispatch` selects which dispatch failures produce warnings. The default value is `0`.

## Ice.Trace.Locator

`Ice.Trace.Locator=num`

The Ice runtime makes [locator](https://docs.zeroc.com/ice/3.8/runtime/locators.md) requests to resolve the endpoints of indirect proxies. Requests on the locator registry are used to update object adapter endpoints and set the server process proxy. This property controls the trace level for the Ice runtime's interactions with the locator:

| Value | Description |
| --- | --- |
| `0` | No locator trace (default). |
| `1` | Trace Ice locator and locator registry requests. |
| `2` | Like `1`, but also trace the removal of endpoints from the cache. |

## Ice.Trace.Network

`Ice.Trace.Network=num`

Controls the trace level for low-level network activities such as connection establishment and read/write operations:

| Value | Description |
| --- | --- |
| `0` | No network trace (default). |
| `1` | Trace established and closed connections, listener activity, and an object adapter's [published endpoints](https://docs.zeroc.com/ice/3.8/runtime/dispatch/object-adapter-endpoints.md). |
| `2` | Like `1`, plus connection attempts and failures, endpoint-resolution failures, bind and accept attempts, rejected connections, and adapters created without endpoints. |
| `3` | Like `2`, plus the number of bytes sent and received in each transport read or write. |

## Ice.Trace.Protocol

`Ice.Trace.Protocol=num`

Controls the trace level for Ice [protocol messages](https://docs.zeroc.com/ice/3.8/protocol/protocol-messages.md):

| Value | Description |
| --- | --- |
| `0` | No protocol trace (default). |
| `1` | Trace Ice protocol messages. |

## Ice.Trace.Retry

`Ice.Trace.Retry=num`

Ice supports [automatic retries](https://docs.zeroc.com/ice/3.8/runtime/invocation/automatic-retries.md) in case of a request failure. This property controls the trace level for retry attempts:

| Value | Description |
| --- | --- |
| `0` | No request retry trace (default). |
| `1` | Trace Ice operation call retries. |
| `2` | Also trace Ice retry for connection establishment failures on Ice locator cached endpoints. |

## Ice.Trace.Slicing

`Ice.Trace.Slicing=num`

The Ice data encoding for [exceptions](https://docs.zeroc.com/ice/3.8/encoding/data-encoding-for-exceptions.md) and [classes](https://docs.zeroc.com/ice/3.8/encoding/data-encoding-for-classes.md) enables a receiver to slice an unknown exception or class type to a known type. This property controls the trace level for slicing activities:

| Value | Description |
| --- | --- |
| `0` | No trace of slicing activity (default). |
| `1` | Trace all exception and class types that are unknown to the receiver and therefore sliced. |

> **C++, C#, Java, Python, Ruby, PHP, MATLAB, and Swift**
>
> ## Ice.Trace.ThreadPool
>
> `Ice.Trace.ThreadPool=num`
>
> Controls the trace level for the Ice [thread pool](https://docs.zeroc.com/ice/3.8/runtime/threading-model.md):
>
> | Value | Description |
> | --- | --- |
> | `0` | No trace of thread pool activity (default). |
> | `1` | Trace the creation, growing, and shrinking of thread pools. |
