Crear sondas

Para crear una sonda, en primer lugar debe crear un archivo fuente de Probekit (archivo probe.) A continuación, en el archivo fuente de Probekit, cree la sonda y añada el contenido que define su funcionamiento.

Para crear un archivo fuente de Probekit, debe utilizar el asistente Archivo fuente de Probekit. Puede continuar utilizando el asistente para crear la sonda y para escribir la mayor parte de la definición de la sonda o puede ir directamente al editor de Probekit. En cualquier caso, debe utilizar el editor de Probekit para escribir el fragmento de código Java correspondiente al código.

Para obtener información detallada acerca de los diferentes componentes de una sonda, consulte la sección Definiciones de sonda.

  1. Para crear el archivo fuente de Probekit:
    1. En las vistas Navegador o Explorador de paquetes, pulse con el botón derecho del ratón el proyecto Java que deberá contener el archivo fuente y pulse Nuevo > Otros.
    2. En la página Seleccionar un asistente, expanda Perfilado y anotaciones y seleccione Archivo fuente de Probekit.
    3. Pulse Siguiente.
    4. En el asistente Crear un archivo de sonda, escriba un nombre para el archivo fuente de sonda nuevo en el campo Nombre de archivo. La extensión del nombre de archivo para los archivos fuente de Probekit debe ser .probe.
    5. En el campo Carpeta fuente, especifique una carpeta fuente de proyecto para que contenga el nuevo archivo fuente de Probekit.
      Nota: Los archivos fuente de sonda deben aparecer en el nivel superior de una carpeta fuente de proyecto; no pueden estar en una subcarpeta.
  2. Si desea salir del asistente ahora y utilizar el editor de Probekit para crear la sonda y su definición:
    1. Seleccione Sin contenido.
    2. Pulse Finalizar. El nuevo archivo fuente de Probekit se añadirá a la carpeta fuente del proyecto y, por omisión, se abrirá automáticamente en el editor de Probekit.
    3. Continúe en el paso 4.
  3. Si desea continuar utilizando el asistente para la creación de la definición de sonda:
    1. Seleccione Sonda de método o Sonda de sitio de llamada.
    2. Seleccione el valor Tipo de fragmento para el fragmento que debe crear el asistente.
    3. Pulse Siguiente.
    4. Utilice los botones Añadir y Editar para definir tantos elementos de datos como desee. Cuando añada o seleccione un elemento, el asistente visualizará una descripción del mismo.
      Nota: Si retrocede y cambia el tipo de sonda creada o el tipo de fragmento que debe insertarse, el editor le solicitará que descarte los elementos que ya no procedan.
    5. Pulse Finalizar. El nuevo archivo fuente de Probekit se añadirá a la carpeta fuente del proyecto y, por omisión, se abrirá automáticamente en el editor de Probekit.
  4. Opcional: en la página General del editor de Probekit, especifique un ID exclusivo para la sonda en el campo ID y un número de versión en el campo Versión, así como valores para una etiqueta. Estos datos únicamente facilitan la identificación de la sonda en la configuración de perfilado.
  5. Pulse la pestaña Sondas.
  6. Si no ha utilizado el asistente para crear la sonda, pulse con el botón derecho en el lado izquierdo del editor de Probekit y seleccione Añadir sonda. La sonda nueva debe crearse en el panel de árbol del lado izquierdo de la página.
  7. Pulse la sonda con el botón derecho del ratón en el panel de árbol y pulse Nuevo > Fragmento. El fragmento nuevo aparece en el panel de árbol como un hijo de la sonda y los campos de propiedad del fragmento se visualizan en el panel de edición del lado derecho de la página.
  8. En el panel de edición, seleccione un valor de Tipo de fragmento y, a continuación, escriba el código Java para el fragmento de sonda. Para obtener información específica, consulte la sección Tipos de fragmentos de sonda.
  9. Continúe definiendo la sonda pulsando con el botón derecho del ratón los elementos del árbol, utilizando el menú emergente para añadir/eliminar elementos hijos y escribiendo valores para los elementos nuevos en el panel de edición. El menú emergente lista sólo los elementos que son válidos para la ubicación seleccionada en el árbol. Si el elemento es válido pero ya no puede añadirse en la ubicación seleccionada, queda inhabilitado en el menú.
    Nota: Cuando escriba un valor en el campo de la propiedad Directiva de importación, escriba sólo el nombre del paquete o la clase que desee importar. No escriba la palabra clave import ni un punto y coma (;) final.
  10. Cuando hay terminado de definir la sonda, pulse Archivo > Guardar.
    Nota: Al guardar el archivo fuente de Probekit, el editor de Probekit comprueba la sintaxis de todos los elementos Java del archivo y notifica los problemas javac. Si existe un error o aviso para una entrada, el icono correspondiente del árbol se cambia por el icono de error o aviso. Los problemas Javac se visualizan en una tabla situada en el extremo inferior de la página Sondas. Efectúe una doble pulsación sobre un elemento de esta tabla para seleccionarlo a fin de editarlo.
Conceptos relacionados
Recopilar datos de sonda: utilización básica
Consulta relacionada
El editor de Probekit
Ejemplos de Probekit