Importar un archivo de anotaciones

Para importar un archivo de anotaciones con el fin de poder analizarlo y correlacionarlo con otros archivos de anotaciones:

  1. Seleccione Archivo > Importar.... El asistente de importación se abre por la página Seleccionar.
  2. En la lista de tipos de orígenes de importación, seleccione Perfilar y anotar > Archivo de anotaciones. Pulse Siguiente. Se abre la página Importar archivo de anotaciones.
  3. Para añadir archivos de anotaciones a importar, pulse Añadir.
  4. Seleccione el tipo de archivo de anotaciones. Pulse la pestaña Nombre de host.
  5. Seleccione el host local o un host remoto en la lista Hosts predeterminados. Pulse la pestaña Detalles.
  6. Seleccione el tipo de anotaciones.


    Nota 1: la lista de tipos de anotaciones pueden filtrarse para que solo se visualicen los tipos interesantes. Aplique un filtro a un tipo de anotaciones eligiendo una de estas opciones:

    Nota 2: marque el recuadro de selección Mostrar categorías para conmutar la visualización de las categorías del analizador de anotaciones (conjuntos.)


  7. Teclee la vía de acceso del archivo que se importa.
     

    Nota 1: esta vía de acceso es sensible a las mayúsculas/minúsculas en todas las plataformas, incluyendo Windows. Utilice el botón de examen para localizar el archivo deseado y evitar problemas de mayúsculas/minúsculas.


    Nota 2: puede importar múltiples archivos de anotaciones del mismo tipo ubicados en un único directorio a la vez especificando una expresión regular entre comillas en el campo de vía de acceso del archivo de anotaciones. Por ejemplo, para importar todas las anotaciones del directorio d:\temp, entre d:\temp\".*" en el campo. Siga las reglas de expresiones regulares de java.util.regex.Pattern. También puede utilizar el diálogo examinar para especificar varios archivos de anotaciones.


    Nota 3: para las importaciones remotas puede especificar un URL FTP o HTTP que señale un archivo de anotaciones o un archivador zip que contenga varios archivos de anotaciones del mismo tipo. El archivo de anotaciones se descargará localmente y se importará después en el espacio de trabajo.

     

  8. Seleccione los detalles de versión del programa que ha creado las anotaciones.

    Nota: para algunos tipos de anotaciones puede ser necesaria la codificación de caracteres, el entorno local, la información de huso horario o una fecha predeterminada para importar un archivo de anotaciones. La normalización de indicaciones de la hora de los registros de anotaciones en un mismo huso horario resulta de utilidad al correlacionar las anotaciones por hora. Algunos tipos de anotaciones solo proporcionan indicaciones de la hora sin información de fechas. Para estos tipos de anotaciones se requiere una fecha predeterminada para completar las indicaciones de la hora de los registros de anotaciones.
  9. Pulse la pestaña Destino.
  10. Especifique el proyecto de destino en el campo Proyecto y el nombre para la unidad lógica de agrupación en el campo Supervisor. (Una unidad lógica de agrupación es una recopilación de anotaciones importadas en la vista Navegador de anotaciones. Puede tener supervisores distintos como sistema de agrupación de anotaciones. Sugerencia: vea las agrupaciones pulsando el icono de flecha abajo en la barra de herramientas del panel Navegador de anotaciones.)
  11. Especifique si el destino es un archivo de anotaciones existente.  Si sustituye a un archivo existente o se añade a otro, siga estos pasos:
    1. Marque el recuadro de selección Fusionar el archivo de anotaciones con un archivo de anotaciones existente.
    2. Seleccione el archivo de anotaciones que se sustituirá o se añadirá.  Pulse Aceptar.
    3. Elija si desea Sustituir o Añadir. Pulse Aceptar.
  12. Pulse la pestaña Filtro. El filtrado le permite reducir el número de registros de anotaciones importados desde el archivo de anotaciones especificando criterios de filtrado. Si no se especifica nada en esta pestaña, se importarán todos los registros de anotaciones del archivo de anotaciones seleccionado.
  13. Opcional: seleccione un filtro ya definido o cree un nuevo filtro para este archivo. Para crear un archivo que sólo importe ciertos registros de anotaciones, efectúe los siguientes pasos:
    1. Pulse Nuevo.
    2. Seleccione Importar anotaciones como tipo de filtro. Pulse Aceptar.
    3. En el diálogo Editar filtro, especifique un Nombre de filtro. Este nombre aparecerá en la lista de selección de la pestaña Filtro para poder aplicar este filtro en los archivos de anotaciones que importe.
    4. Defina el filtro utilizando uno o los dos mecanismos de las dos pestañas: Estándar o Avanzado. La pestaña Estándar le permite establecer rápidamente algunos filtros sencillos y comunes. La pestaña Avanzado le permite crear filtros muy personalizados.
    5. Para definir un filtro estándar:
      1. Marque el recuadro de selección Filtrar por eventos si desea importar un cierto número o período de tiempo de eventos al principio o al final del archivo de anotaciones. A continuación, en el primer campo, seleccione si desea importar eventos desde el principio (primero) o desde el final (último) del archivo de anotaciones. En el tercer campo, seleccione si desea importar un cierto número de segundos o un cierto número de eventos. En el segundo campo, entre el número de segundos o eventos que desea importar.
         

        Por ejemplo, si desea importar 400 eventos desde el principio del archivo de anotaciones, la línea Mostrar debe rezar: primeros 400 eventos. Si desea importar eventos producidos durante los últimos 10 segundos del archivo de anotaciones, la línea Mostrar debe rezar: últimos 10 segundos.

      2. Marque el recuadro de selección Mostrar eventos por gravedad si desea importar registros de anotaciones de ciertas gravedades. A continuación, marque los recuadros de selección situados junto a Errores, Avisos e Información para indicar los tipos que deben importarse.
    6. Para definir un filtro avanzado:
      1. Pulse la pestaña Avanzado. La tabla de Filtrado avanzado muestra todos los criterios de filtrado definidos. Los registros de anotaciones que coincidan con uno o varios criterios se importarán.
      2. Para añadir una entrada en la tabla, pulse Añadir. Seleccione el atributo por el que desee filtrar en la lista de atributos de evento base común primario. Seleccione el operador (like realiza una coincidencia de patrón). Entre un valor que deban tener los registros de anotaciones para que se importen:
        • Utilice un asterisco (*) para representar cualquier serie.
        • Utilice una barra (|) para representar un "or" no exclusivo.
        • Los valores de hora deben tener el formato ISO de aaaa-mm-dd hh:mm:ss.sTZD, donde:
          • aaaa es el valor del año con cuatro dígitos
          • mm es el valor del mes con dos dígitos
          • dd es el valor del día con dos dígitos
          • hh es el valor de la hora con dos dígitos, en un reloj de 24 horas
          • mm es el valor de los minutos con dos dígitos
          • ss.s es el valor de los segundos con dos dígitos y una fracción opcional de segundos tras el decimal
          • TZD es un designador de huso horario, ya sea una hora de seis caracteres relativa al Tiempo Universal Coordinado (UTC) como +05:00 ó -07:00; o bien una abreviatura de huso horario como EST o GMT. Consulte el documento http://www.w3.org/TR/NOTE-datetime para obtener información sobre el formato y http://www.timeanddate.com/library/abbreviations/timezones/ para obtener un listado de las abreviaturas de husos horarios.

        Pulse Aceptar.

      3. Para editar una entrada existente, selecciónela, pulse Editar y modifique los campos.
      4. Para eliminar una entrada, selecciónela y pulse Eliminar.
    7. Pulse Aceptar.
  14. Pulse Finalizar para importar el archivo de anotaciones.

En función del tamaño del archivo de anotaciones, la importación puede tardar algún tiempo. Para ver el estado de la importación, pulse el botón Progreso El botón Progreso situado en la esquina inferior derecha del entorno de trabajo. Se abrirá la vista Progreso en la que podrá ver el progreso de todos los trabajos activos. Si desea detener la importación de unas anotaciones, pulse el botón rojo Detener situado junto al nombre de las anotaciones; los registros se importarán hasta el punto en que detenga la operación.

Una vez finaliza la importación (o se detiene), el archivo importado se abre en la vista Anotaciones.

Vista Anotaciones

Por omisión, todos los archivos de anotaciones importados se serializarán en una preferencia de Conjunto de anotaciones por omisión, lo que permite reimportar los archivos fácilmente.

Nota: asegúrese de que la versión de las anotaciones que está importando coincide con la versión de la aplicación seleccionada en la pestaña Detalles. Un número de versión no coincidente implicará la utilización de un analizador erróneo al importar el archivo. La vista Navegador de anotaciones listará las anotaciones, pero la vista Anotaciones estará vacía.

Si ha importado un archivo de anotaciones que incluye una correlación interna (por ejemplo. algunas anotaciones de rastreo de servidor de aplicaciones), se añadirá un objeto de correlación a la lista de Correlaciones, con un nombre generado que empieza por el nombre del motor asociado.

Conceptos relacionados
Determinar problemas en las aplicaciones distribuidas utilizando el analizador de anotaciones y rastreo

Tareas relacionadas
Importar una base de datos de síntomas
Trabajar con un archivo de anotaciones
Trabajar con conjuntos de anotaciones
Exportar una anotación o una correlación a representaciones de Evento base común