> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Methoden-Instrumentierung hinzufügen

<Tip>
  <p>Hinweise:</p>

  <ul>
    <li>
      Dieses Feature ist seit Ruby-Gem-Version 1.3 verfügbar und funktioniert nur für
      Klassen.
    </li>

    <li>
      Ruby 3.0-Unterstützung für Keyword-Argumente wurde in Ruby-Gem `2.11.4` hinzugefügt.
    </li>
  </ul>
</Tip>

Manchmal sind [Instrumentierungs-Blöcke](/ruby/instrumentation/instrumentation) nicht genau genug. Jede Anwendung ist anders, und ebenso der Code, der sie ausführt. Entwickler wissen, welchen Code und, genauer gesagt, welche Methoden zu instrumentieren sind.

Es ist möglich, Methoden in Ihrem Ruby-Code direkt mit AppSignal zu instrumentieren.
Mit dem `appsignal` Ruby-Gem können Sie unsere Objekt-Integrationen verwenden, die
Ihnen einige nützliche Helper dafür bereitstellen.

## Installation

Aktivieren Sie die Objekt-Integration, indem Sie die folgende Zeile nach dem Laden des
appsignal-Gems selbst requiren

<CodeGroup>
  ```ruby Ruby theme={null}
  require 'appsignal/integrations/object'
  ```
</CodeGroup>

und fahren Sie damit fort, die Methoden anzugeben, die Sie in einer beliebigen Klasse testen möchten.

### Beispiel

<CodeGroup>
  ```ruby Ruby theme={null}
  require 'appsignal'
  require 'appsignal/integrations/object'

  class Foo
    def bar
      1
    end
    appsignal_instrument_method :bar

    def self.bar
      2
    end
    appsignal_instrument_class_method :bar
  end

  Foo.new.bar
  # => 1
  Foo.bar
  # => 2
  ```
</CodeGroup>

## Verwendung

Wir haben unterschiedliche Helper für Instanzmethoden und Klassenmethoden,
`appsignal_instrument_method` bzw. `appsignal_instrument_class_method`.

Rufen Sie sie auf Klassenebene in jeder Ruby-Klasse auf, auch in denen aus der Ruby-Standardbibliothek,
und beginnen Sie mit der Instrumentierung. Sie müssen nichts weiter in der
Klasse einbinden; sobald Sie die Integrationsdatei laden, wird sie überall verfügbar.

Instrumentieren Sie eine beliebige Methode, indem Sie den Helper mit dem Namen der Methode aufrufen,
die Sie instrumentieren möchten. Wenn die Methode nicht existiert, wird ein Fehler ausgelöst,
genau wie Ruby es standardmäßig tun würde.

Sobald ein Request mit dieser Art von
Instrumentierung von AppSignal verarbeitet wurde, können Sie die Methoden-Instrumentierung in der Event-Aufschlüsselung
auf der Sample-Seite sehen.

<img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/method_instrumentation.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=52f4c7f087df04214b1c2d01be8caa89" alt="Event tree with method instrumentation" width="702" height="348" data-path="assets/images/screenshots/method_instrumentation.png" />

Sie können den Namen des Events, das an uns gesendet wird, auch mit der
Option `:name` anpassen.

<CodeGroup>
  ```ruby Ruby theme={null}
  class Foo
    def bar
    end
    appsignal_instrument_method :bar

    def self.bar
    end
    appsignal_instrument_class_method :bar, name: "bar.class_method.Foo.methods"
  end
  ```
</CodeGroup>