Consideraciones sobre la visualización de registros desde la consola

Cuando desee utilizar el registro desde la consola, primero debe configurar los registros de la plataforma ' IBM Cloud Logs ' para recibir los datos de registro de ' Code Engine '. Para comprobar si hay instancias de IBM Cloud Logs activas, consulte el panel de control de observabilidad.

Revise la información del plan de servicio IBM Cloud Logs al considerar las necesidades de retención, búsqueda y análisis de registros.

Al ver los datos de registro de aplicaciones Code Engine, ejecuciones de su trabajo o ejecuciones de su compilación, pueden producirse retrasos antes de que los datos estén disponibles en IBM Cloud Logs. Por ejemplo, los datos de registro pueden tardar entre 5 y 10 minutos en aparecer en IBM Cloud Logs, especialmente si se utiliza la canalización de datos ' Store and search.

Revise la documentación sobre Data Pipelines para conocer las opciones para equilibrar la latencia y el coste de los registros para sus instancias IBM Cloud Logs.

When you use logging with the CLI, you do not need to configure IBM Cloud Logs platform logs, as the Code Engine CLI logging fetches its data differently.

Las capacidades de registro ofrecidas a través de la CLI son limitadas y sólo deben considerarse para fines de desarrollo. Cuando se ejecuta una carga de trabajo de producción, siempre se debe utilizar una instancia IBM Cloud Logs, que ofrece funciones de retención, filtrado y búsqueda de registros.

Visualización de registros de app, trabajo o función desde la consola

Puede ver registros para apps, trabajos o funciones. Los pasos para ver cualquiera de estos desde la consola son muy similares.

Después de seleccionar el proyecto con el que desea trabajar, puede añadir prestaciones de registro desde la página Code Engine Visión general o una de sus páginas hijo como, por ejemplo, la página Aplicaciones, Trabajos o Funciones ; o desde la página específica de la aplicación, trabajo o función. Los pasos siguientes presuponen que está trabajando desde una página Code Engine específica.

1. Vaya a una aplicación, trabajo o función que haya creado y desplegado. En la página Proyectos de la consola de Code Engine, seleccione el proyecto y, a continuación, seleccione Aplicaciones, Trabajos o Funciones según corresponda. Seleccione la aplicación, trabajo o función con la que desea trabajar.
2. Si ha creado previamente una instancia " IBM Cloud Logs ", haga clic en " Registro, para abrir el servicio " IBM Cloud Logs.
3. Añadir y configurar prestaciones de registro:
   1. En el menú de opciones Probar aplicación, Enviar trabajo o Probar función, haga clic en Añadir registro para crear la instancia IBM Cloud Logs. Esta acción abre el servicio IBM Cloud Logs.
   2. Desde el servicio IBM Cloud Logs, cree la instancia de registro. Para confirmar que se ha creado la instancia de registro, compruebe el panel de control de observabilidad.
   3. En la aplicación, trabajo o página de función de Code Engine, pulse Añadir registro en el menú de opciones Probar aplicación, Enviar trabajo o Probar función. Esta vez, seleccione una instancia IBM Cloud Logs para recibir los registros de la plataforma. Elija la instancia de registro que creó en el paso anterior. Pulse Seleccionar. Code Engine requiere registros de plataforma habilitados para recibir datos de registro de Code Engine. Cuando complete esta acción, Code Engine habilitará el registro de plataforma.
4. Ahora que los registros de plataforma están configurados, en la página de app, trabajo o función de Code Engine, pulse Registro en el menú de opciones Probar aplicación, Enviar trabajo o Probar función para abrir la ventana de registros de plataforma. Para confirmar que se han establecido los registros de plataforma para la región, consulte el panel de control de observabilidad.
5. (opcional) Limite el filtro para la búsqueda, si es necesario.
6. Verifique la configuración realizando uno de los pasos siguientes:
   • Para una aplicación o función, pruébela: haga clic Aplicación de prueba o Función de prueba según corresponda y luego haga clic en Enviar petición. Para abrir la aplicación o función en una página web, pulse URL de aplicación o URL de función. Puede ver los registros de la plataforma de la prueba en la ventana de registros de la plataforma.
   • Para un trabajo, ejecútelo: en el área Ejecuciones de trabajos, pulse Enviar trabajo para ejecutar el trabajo. Proporcione los valores de configuración de la ejecución del trabajo o si lo desea puede adoptar los valores predeterminados. Pulse Enviar trabajo para ejecutar el trabajo. Puede ver los registros de la plataforma desde la ejecución del trabajo en la ventana de registros de la plataforma.

Su instancia ' IBM Cloud Logs ' está ahora configurada de tal manera que puede recibir el registro de la plataforma para su aplicación, trabajo o función ' Code Engine '.

También puede configurar una instancia IBM Cloud Logs utilizando el panel de control de Observability para crear la instancia y, a continuación, configurando el enrutamiento de los registros de la plataforma.

Visualización de registros de compilación desde la consola

Puede visualizar registros para instancias de ejecución de compilación específicas desde la consola.

1. Vaya al panel de control de Code Engine.
2. Seleccione un proyecto (o cree uno).
3. En la página del proyecto, pulse Compilaciones de imágenes.
4. En el separador Compilación de imagen, pulse el nombre de la compilación de imagen para abrir la página de compilación para una compilación definida o cree una compilación.
5. En la página de compilación de la compilación definida, pulse el nombre de la instancia de la ejecución de la compilación en la sección Ejecuciones de compilación. Es posible que tenga que pulsar Enviar compilación para crear una ejecución de compilación. Puede ver los registros de la plataforma desde la ejecución de la compilación en la ventana de registros de la plataforma. De forma alternativa, también puede ver información de registro de compilación para los detalles del paso de compilación desde la página de instancia de ejecución de compilación. Expanda los pasos de compilación para datos de registro de pasos de compilación específicos. Opcionalmente, puede refinar el filtro para la búsqueda, si es necesario.

Visualización de registros de aplicación con la CLI

Para ver registros de app para una app específica con la CLI, utilice el mandato application logs. Puede visualizar registros de todas las instancias de una aplicación o visualizar registros de una instancia específica de una aplicación. El mandato app get muestra los detalles de la app, incluidas las instancias de ejecución de la app.

• Para ver los registros para todas las instancias de la app myapp, especifique el nombre de la app con la opción --app; por ejemplo,

  ibmcloud ce app logs --app myapp
  

  Salida de ejemplo

  Getting logs for all instances of application 'myapp'...
  OK
  
  myapp-ii18y-2-deployment-7657c5f4f9-dgk5f:
  Server running at http://0.0.0.0:8080/
  

• Para ver los registros para una instancia específica de la app, especifique el nombre de la instancia específica de la app con la opción --instance; por ejemplo,

  ibmcloud ce app logs --instance myapp-ii18y-2-deployment-7657c5f4f9-dgk5f
  

  Salida de ejemplo

  Getting logs for application instance 'myapp-a5yp2-2-deployment-65766594d4-hj6c5'...
  OK
  
  myapp-a5yp2-2-deployment-65766594d4-hj6c5:
  Server running at http://0.0.0.0:8080/
  

Visualización de registros del trabajo con la CLI

Para ver registros para una ejecución de trabajo específica con la CLI, utilice el mandato jobrun logs. Puede visualizar registros de todas las instancias de una ejecución de trabajo o visualizar registros de una instancia específica de una ejecución de trabajo. El mandato jobrun get muestra detalles sobre la ejecución de trabajo, incluidas las instancias de la ejecución de trabajo.

• Para ver los registros para todas las instancias de la ejecución del trabajo testjobrun, especifique el nombre de la ejecución de trabajo con la opción --jobrun; por ejemplo,

  ibmcloud ce jobrun logs --jobrun testjobrun
  

  Salida de ejemplo

  Getting jobrun 'testjobrun'...
  Getting instances of jobrun 'testjobrun'...
  Getting logs for all instances of job run 'testjobrun'...
  OK
  
  testjobrun-1-0:
  Hello World!
  
  testjobrun-2-0:
  Hello World!
  
  testjobrun-3-0:
  Hello World!
  
  testjobrun-4-0:
  Hello World!
  
  testjobrun-5-0:
  Hello World!
  

• Para ver los registros para la instancia de la ejecución de trabajo testjobrun-1-0, especifique el nombre de una instancia específica de la ejecución de trabajo con la opción --instance; por ejemplo,

  ibmcloud ce jobrun logs --instance testjobrun-1-0
  

  Salida de ejemplo

  Getting logs for job run instance 'testjobrun-1-0'...
  OK
  
  testjobrun-1-0:
  Hello World!
  

Visualización de registros de compilación con la CLI

Para ver los registros de compilación para una ejecución de compilación específica con la CLI, utilice el mandato buildrun logs. Puede visualizar registros de todas las instancias de una ejecución de compilación a partir del nombre de la ejecución de compilación.

Para ver los registros para todas las instancias de la ejecución de compilación mybuildrun, especifique el nombre de la ejecución de compilación con la opción --name; por ejemplo,

ibmcloud ce buildrun logs --name mybuildrun

Salida de ejemplo

Getting build run 'mybuildrun'...
Getting instances of build run 'mybuildrun'...
Getting logs for build run 'mybuildrun'...
OK

mybuildrun-zg5rj-pod-z5gzb/step-git-source-source-r9fcf:
{"level":"info","ts":1614363665.8331757,"caller":"git/git.go:169","msg":"Successfully cloned https://github.com/IBM/CodeEngine @ 8b514ce871e50d67cfea3e344b90cade4bd26e90 (grafted, HEAD, origin/main) in path /workspace/source"}
{"level":"info","ts":1614363666.82988,"caller":"git/git.go:207","msg":"Successfully initialized and updated submodules in path /workspace/source"}

mybuildrun-zg5rj-pod-z5gzb/step-build-and-push:
INFO[0002] Retrieving image manifest node:12-alpine
INFO[0002] Retrieving image node:12-alpine
INFO[0003] Retrieving image manifest node:12-alpine
INFO[0003] Retrieving image node:12-alpine
INFO[0003] Built cross stage deps: map[]
INFO[0003] Retrieving image manifest node:12-alpine
INFO[0003] Retrieving image node:12-alpine
INFO[0004] Retrieving image manifest node:12-alpine
INFO[0004] Retrieving image node:12-alpine
INFO[0004] Executing 0 build triggers
INFO[0004] Unpacking rootfs as cmd RUN npm install requires it.
INFO[0008] RUN npm install
INFO[0008] Taking snapshot of full filesystem...
INFO[0010] cmd: /bin/sh
INFO[0010] args: [-c npm install]
INFO[0010] Running: [/bin/sh -c npm install]
npm WARN saveError ENOENT: no such file or directory, open '/package.json'
npm notice created a lockfile as package-lock.json. You should commit this file.
npm WARN enoent ENOENT: no such file or directory, open '/package.json'
npm WARN !invalid#2 No description
npm WARN !invalid#2 No repository field.
npm WARN !invalid#2 No README data
npm WARN !invalid#2 No license field.

up to date in 0.267s
found 0 vulnerabilities

INFO[0011] Taking snapshot of full filesystem...
INFO[0011] COPY server.js .
INFO[0011] Taking snapshot of files...
INFO[0011] EXPOSE 8080
INFO[0011] cmd: EXPOSE
INFO[0011] Adding exposed port: 8080/tcp
INFO[0011] CMD [ "node", "server.js" ]

mybuildrun-zg5rj-pod-z5gzb/step-image-digest-exporter-ngl6j:
2021/02/26 18:21:02 warning: unsuccessful cred copy: ".docker" from "/tekton/creds" to "/tekton/home": unable to open destination: open /tekton/home/.docker/config.json: permission denied
{"severity":"INFO","timestamp":"2021-02-26T18:21:26.372494581Z","caller":"logging/config.go:116","message":"Successfully created the logger."}
{"severity":"INFO","timestamp":"2021-02-26T18:21:26.372621756Z","caller":"logging/config.go:117","message":"Logging level set to: info"}