---
title: "The admin Object"
url: https://docs.zeroc.com/ice/3.8/administration/administrative-facility/admin-object
language: java
docs_index: https://docs.zeroc.com/llms.txt
---

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

# The admin Object

Programming language: Java. Other languages: [C++](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/admin-object/cpp.md), [C#](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/admin-object/csharp.md), [JavaScript](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/admin-object/js.md), [MATLAB](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/admin-object/matlab.md), [PHP](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/admin-object/php.md), [Python](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/admin-object/python.md), [Ruby](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/admin-object/ruby.md), [Swift](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/admin-object/swift.md).

The `admin` object of a communicator is an Ice object that clients use to administer this communicator remotely. Each administrative capability is a separate [facet](https://docs.zeroc.com/ice/3.8/runtime/facets/java.md) of this object.

The Ice runtime provides four built-in facets:

- [Process](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/process-facet/java.md) lets a client, such as an IceGrid node, gracefully shut down the communicator.
- [Properties](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/properties-facet/java.md) lets a client read and update the communicator's properties.
- [Logger](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/logger-facet/java.md) lets a client retrieve recent messages from the Ice logger and receive new ones through a remote logger.
- [Metrics](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/metrics-facet/java.md) lets a client retrieve the metrics of the Ice runtime.

An application can [choose which facets the communicator enables](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/filtering-administrative-facets/java.md) and [add its own facets](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/custom-administrative-facets/java.md).

## Hosting the admin Object

When the administrative facility is enabled, Ice hosts the `admin` object in the built-in `Ice.Admin` object adapter, or the application hosts it in one of its own object adapters by calling [`createAdmin`](https://code.zeroc.com/ice/3.8/api/java/com.zeroc.ice/com/zeroc/Ice/Communicator.html#createAdmin(com.zeroc.Ice.ObjectAdapter,com.zeroc.Ice.Identity)). [Creating the admin Object](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/java.md) describes how to enable the administrative facility and configure the `Ice.Admin` object adapter.

`getAdmin` on the [communicator](https://code.zeroc.com/ice/3.8/api/java/com.zeroc.ice/com/zeroc/Ice/Communicator.html) returns a proxy for the `admin` object. [Using the admin Object](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/using-the-admin-object/java.md) describes how to reach its facets.

## See Also

- [Facets](https://docs.zeroc.com/ice/3.8/runtime/facets/java.md)
- [Using the admin Object](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/using-the-admin-object/java.md)
- [Ice.Admin.\*](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/java.md)
