---
title: "The admin Object"
url: https://docs.zeroc.com/ice/3.8/administration/administrative-facility/admin-object
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

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/administration/administrative-facility/admin-object/cpp.md), [C#](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/admin-object/csharp.md), [Java](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/admin-object/java.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), and [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.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.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.md) lets a client read and update the communicator's properties.
- [Logger](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/logger-facet.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.md) lets a client retrieve the metrics of the Ice runtime.

> **C++, C#, Java, MATLAB, PHP, Python, Ruby, and Swift**
>
> An application can [choose which facets the communicator enables](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/filtering-administrative-facets.md) (C++, C#, Java, Python, and Swift: and [add its own facets](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/custom-administrative-facets.md)).
>
> ## Hosting the admin Object
>
> When the administrative facility is enabled, Ice hosts the `admin` object in the built-in `Ice.Admin` object adapter (C++, C#, Java, Python, and Swift: or the application hosts it in one of its own object adapters by calling `createAdmin` ([C++](https://code.zeroc.com/ice/3.8/api/cpp/classIce_1_1Communicator_a87511b9f8ea733ab31e6680ab8e1234f.html#a87511b9f8ea733ab31e6680ab8e1234f), [C#](https://code.zeroc.com/ice/3.8/api/csharp/api/Ice.Communicator.html#Ice_Communicator_createAdmin_), [Java](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)), [Python](https://code.zeroc.com/ice/3.8/api/python/Ice.Communicator.html#Ice.Communicator.createAdmin), and [Swift](https://code.zeroc.com/ice/3.8/api/swift/documentation/ice/communicator/createadmin(adminadapter:adminid:)))). [Creating the admin Object](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object.md) describes how to enable the administrative facility and configure the `Ice.Admin` object adapter.

> **C++, C#, Java, Python, and Swift**
>
> `getAdmin` on the communicator ([C++](https://code.zeroc.com/ice/3.8/api/cpp/classIce_1_1Communicator.html), [C#](https://code.zeroc.com/ice/3.8/api/csharp/api/Ice.Communicator.html), [Java](https://code.zeroc.com/ice/3.8/api/java/com.zeroc.ice/com/zeroc/Ice/Communicator.html), [Python](https://code.zeroc.com/ice/3.8/api/python/Ice.Communicator.html), and [Swift](https://code.zeroc.com/ice/3.8/api/swift/documentation/ice/communicator)) 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.md) describes how to reach its facets.

## See Also

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