

AWS Data Pipeline ya no está disponible para nuevos clientes. Los clientes actuales de AWS Data Pipeline pueden seguir utilizando el servicio con normalidad. [Más información](https://aws.amazon.com/blogs/big-data/migrate-workloads-from-aws-data-pipeline/)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Visualización de registros de canalización
<a name="dp-viewing-logs"></a>

El registro de nivel de canalización se admite en el momento de crear la canalización si se especifica una ubicación de Amazon S3 en la consola o mediante un valor de `pipelineLogUri` en el objeto predeterminado en el SDK o la CLI. La estructura de directorios para cada canalización dentro de dicho URI es como la siguiente:

```
{{pipelineId}}
    -{{componentName}}
        -{{instanceId}}
            -{{attemptId}}
```

Para la canalización, `df-00123456ABC7DEF8HIJK`, la estructura del directorio tiene este aspecto:

```
df-00123456ABC7DEF8HIJK
    -ActivityId_fXNzc
        -@ActivityId_fXNzc_2014-05-01T00:00:00
            -@ActivityId_fXNzc_2014-05-01T00:00:00_Attempt=1
```

En el caso de `ShellCommandActivity`, en cada intento se almacenan en el directorio los registros `stderr` y `stdout` asociados a estas actividades.

Para los recursos como `EmrCluster`, donde se establece un valor de `emrLogUri`, ese valor tiene precedencia. De lo contrario, los recursos (incluidos TaskRunner los registros de esos recursos) siguen la estructura de registro de canalización anterior.

Para ver los registros de una ejecución de canalización determinada:

1. Recupere el `ObjectId` llamando a `query-objects` para obtener el ID exacto del objeto. Por ejemplo:

   ```
   aws datapipeline query-objects --pipeline-id <pipeline-id> --sphere ATTEMPT --region ap-northeast-1
   ```

   `query-objects` es una CLI paginada y puede devolver un token de paginación si hay más ejecuciones para un `pipeline-id` determinado. Puede usar el token para realizar todos los intentos hasta encontrar el objeto esperado. Por ejemplo, una devolución ObjectId tendría el siguiente aspecto:`@TableBackupActivity_2023-05-020T18:05:18_Attempt=1`.

1. Usando el ObjectId, recupera la ubicación del registro usando:

   ```
   aws datapipeline describe-objects —pipeline-id <pipeline-id> --object-ids <object-id> --query "pipelineObjects[].fields[?key=='@logLocation'].stringValue"
   ```

**Mensaje de error de una actividad fallida**  
Para obtener el mensaje de error, primero obtenga el ObjectId uso`query-objects`.

Después de recuperar el error ObjectId, utilice la `describe-objects` CLI para obtener el mensaje de error real.

```
aws datapipeline describe-objects --region ap-northeast-1 --pipeline-id <pipeline-id> --object-ids <object-id> --query "pipelineObjects[].fields[?key=='errorMessage'].stringValue"
```

**Cancelar, volver a ejecutar o marcar un objeto como terminado**  
Utilice la CLI `set-status` para cancelar un objeto en ejecución, volver a ejecutar un objeto fallido o marcar un objeto en ejecución como Finalizado.

Primero, obtenga el ID del objeto mediante la CLI `query-objects`. Por ejemplo:

```
aws datapipeline query-objects --pipeline-id <pipeline-id> --sphere INSTANCE --region ap-northeast-1
```

Utilice la CLI `set-status` para cambiar el estado del objeto deseado. Por ejemplo:

```
aws datapipeline set-status —pipeline-id <pipeline-id> --region ap-northeast-1 --status TRY_CANCEL --object-ids <object-id>
```