Criar sondas

Para criar uma sonda, crie primeiro um ficheiro de origem Probekit (ficheiros probe). Em seguida, no ficheiro de origem Probekit, crie a sonda e adicione o conteúdo que define o funcionamento da mesma.

Para criar um ficheiro de origem Probekit, é necessário utilizar o assistente Ficheiro de Origem Probekit. Pode continuar a utilizar o assistente para criar a sonda e para escrever a maioria das definições da sonda ou seguir directamente para o editor do Probekit. Em qualquer um dos casos, deve utilizar o editor do Probekit para escrever o fragmento de código Java para o código.

Para informações mais detalhadas sobre os componentes diferentes de uma sonda, consulte Definições de sondas.

  1. Para criar o ficheiro de origem Probekit:
    1. Na vista Navegador ou Explorador de Pacotes, faça clique com o botão direito do rato no projecto Java que pretende que contenha o ficheiro de origem e depois faça clique em Novo > Outros.
    2. Na página Seleccionar assistente, expanda Perfilar e Registar e seleccione Ficheiro de Origem Probekit.
    3. Faça clique em Seguinte.
    4. No assistente Criar uma Nova Sonda, introduza um nome para o ficheiro de origem da nova sonda no campo Nome de ficheiro. A extensão do nome de ficheiro para os ficheiros de origem Probekit deve ser .probe.
    5. No campo Pasta Origem, introduza uma pasta origem de projecto para conter o novo ficheiro de origem Probekit.
      Nota: Os ficheiros origem Probekit devem aparecer no nível superior de uma pasta origem de projecto; não podem estar numa subpasta.
  2. Se quiser sair do assistente agora e utilizar o editor do Probekit para criar a sua sonda e respectiva definição:
    1. Seleccione Sem Conteúdo.
    2. Faça clique em Terminar. O novo ficheiro de origem Probekit é adicionado à pasta origem do projecto e, por predefinição, abre-se automaticamente no editor do Probekit.
    3. Continue com o passo 4.
  3. Se quiser continuar a utilizar o assistente para o ajudar na criação da definição de sonda:
    1. Seleccione Sonda de Método ou Sonda de Callsite .
    2. Seleccione o valor de Tipo de Fragmento para o fragmento que pretende que o assistente crie.
    3. Faça clique em Seguinte.
    4. Utilize os botões Adicionar e Editar para definir os artigos que desejar. Ao adicionar ou seleccionar um artigo, o assistente apresenta a descrição do mesmo.
      Nota: Se voltar atrás e alterar o tipo de sonda a criar ou o tipo de fragmento a inserir, o editor perguntará se é de descartar artigos que já não sejam aplicáveis.
    5. Faça clique em Terminar. O novo ficheiro de origem Probekit é adicionado à pasta origem do projecto e, por predefinição, abre-se automaticamente no editor do Probekit.
  4. Opcional: Na página Geral do editor do Probekit, introduza uma cadeia de ID única para a sonda no campo ID e um número de versão no campo Versão, assim como valores para uma etiqueta. Estes dados destinam-se somente a conveniência do utilizador na identificação da sonda na configuração de perfilamento.
  5. Faça clique no separador Sondas.
  6. Se não utilizou o assistente para criar a sonda, faça clique com o botão direito do rato no lado esquerdo do editor do Probekit e seleccione Adicionar Sonda. A nova sonda deverá ser criada na área da janela em árvore no lado esquerdo da página.
  7. Faça clique com o botão direito do rato na sonda na área de janela em árvore e faça clique em Novo > Fragmento. O novo fragmento aparece na área de janela em árvore como descendente da sonda e os campos de propriedades do fragmento são apresentados na área de janela de edição no lado direito da página.
  8. Na área de janela de edição, seleccione um valor de Tipo de Fragmento e introduza o código Java para o fragmento da sonda. Para informações mais específicas, consulte Tipos de fragmentos de sonda.
  9. Continue a definir a sua sonda fazendo clique com o botão direito do rato na árvore, através da utilização do menu emergente para adicionar/remover artigos descendentes e introduzindo valores para os novos artigos na área de janela de edição. O menu emergente enumera somente os artigos que forem válidos para a localização que estiver seleccionada na árvore. Se o artigo for válido mas já não puder ser adicionado na localização seleccionada, o artigo estará desactivado no menu.
    Nota: Ao introduzir um valor no campo de propriedade Directiva de importação, introduza somente o nome do pacote ou da classe que pretende importar. Não introduza a palavra-chave import nem o ponto e vírgula final (;).
  10. Quando terminar de definir a sua sonda, faça clique em Ficheiro > Guardar.
    Nota: Quando guardar o ficheiro de origem Probekit, o editor do Probekit verifica a sintaxe de todos os elementos Java no ficheiro e reporta eventuais problemas javac. Se houver um erro ou aviso relativo a uma entrada, o ícone correspondente na árvore passa a ser um ícone de erro ou aviso. Os problemas javac são apresentados numa tabela no fundo da página Sondas. Faça clique duas vezes num artigo desta tabela para focar o artigo para fins de edição.
Conceitos relacionados
Coligir dados de sondas: Utilização básica
Referência relacionada
O editor do Probekit
Exemplos de Probekit