# docker service inspect

**Descripción:** Muestra información detallada sobre uno o más servicios

**Uso:** `docker service inspect [OPTIONS] SERVICE [SERVICE...]`








**Orquestador:** Swarm

## Descripción

Inspecciona el servicio especificado.

Por defecto, este comando muestra todos los resultados en una matriz JSON. Si se especifica un formato,
la plantilla dada se ejecutará para cada resultado.

El paquete [text/template](https://pkg.go.dev/text/template) de Go
describe todos los detalles del formato.

> [!NOTE]
> Este es un comando de gestión de clústeres y debe ejecutarse en un nodo administrador de Swarm (manager node).
> Para obtener más información sobre administradores y trabajadores, consulta la
> [sección del modo Swarm](/engine/swarm/) en la
> documentación.


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `-f`, `--format` |  |  Da formato a la salida utilizando una plantilla personalizada:<br>'json':             Imprime en formato JSON<br>'TEMPLATE':         Imprime la salida utilizando la plantilla Go especificada.<br>Consulta https://docs-docker.esdocu.com/go/formatting/ para obtener más información sobre cómo dar formato a la salida con plantillas |

 | `--pretty` |  |  Imprime la información en un formato legible para humanos |




## Ejemplos

### Inspeccionar un servicio por nombre o ID

Puedes inspeccionar un servicio, ya sea por su *nombre* o por su *ID*.

Por ejemplo, dado el siguiente servicio:

```console
$ docker service ls
ID            NAME   MODE        REPLICAS  IMAGE
dmu1ept4cxcf  redis  replicated  3/3       redis:7.4.1
```

Tanto `docker service inspect redis` como `docker service inspect dmu1ept4cxcf`
producen el mismo resultado:

```console
$ docker service inspect redis
```

La salida está en formato JSON, por ejemplo:

```json
[
  {
    "ID": "dmu1ept4cxcfe8k8lhtux3ro3",
    "Version": {
      "Index": 12
    },
    "CreatedAt": "2016-06-17T18:44:02.558012087Z",
    "UpdatedAt": "2016-06-17T18:44:02.558012087Z",
    "Spec": {
      "Name": "redis",
      "TaskTemplate": {
        "ContainerSpec": {
          "Image": "redis:7.4.1"
        },
        "Resources": {
          "Limits": {},
          "Reservations": {}
        },
        "RestartPolicy": {
          "Condition": "any",
          "MaxAttempts": 0
        },
        "Placement": {}
      },
      "Mode": {
        "Replicated": {
          "Replicas": 1
        }
      },
      "Mode": {
        "Replicated": {
          "Replicas": 1
        }
      },
      "UpdateConfig": {},
      "EndpointSpec": {
        "Mode": "vip"
      }
    },
    "Endpoint": {
      "Spec": {}
    }
  }
]
```

```console
$ docker service inspect dmu1ept4cxcf

[
  {
    "ID": "dmu1ept4cxcfe8k8lhtux3ro3",
    "Version": {
      "Index": 12
    },
    ...
  }
]
```

### Dar formato legible (--pretty) {#pretty}

Puedes imprimir la salida de la inspección en un formato legible para humanos en lugar de la salida
JSON predeterminada, utilizando la opción `--pretty`:

```console
$ docker service inspect --pretty frontend

ID:     c8wgl7q4ndfd52ni6qftkvnnp
Name:   frontend
Labels:
 - org.example.projectname=demo-app
Service Mode:   REPLICATED
 Replicas:      5
Placement:
UpdateConfig:
 Parallelism:   0
 On failure:    pause
 Max failure ratio: 0
ContainerSpec:
 Image:     nginx:alpine
Resources:
Networks:   net1
Endpoint Mode:  vip
Ports:
 PublishedPort = 4443
  Protocol = tcp
  TargetPort = 443
  PublishMode = ingress
```

También puedes utilizar `--format pretty` para obtener el mismo efecto.

### Dar formato a la salida (--format) {#format}

La opción `--format` se puede utilizar para obtener información específica sobre un
servicio. Por ejemplo, el siguiente comando muestra el número de réplicas
del servicio "redis".

```console
$ docker service inspect --format='{{.Spec.Mode.Replicated.Replicas}}' redis

10
```