AWS Fargate überwachen

Der Fargate-Collector Node.js wird über eine Docker -Agentenimageebene bereitgestellt, die die Kollektordateien und ein Initialisierungsscript enthält.

• Wenn Ihre Anwendung mit CommonJS, entwickelt wurde, richten Sie den Fargate-Collector unter Node.js ein, indem Sie die Schritte im Abschnitt CommonJS befolgen.
• Wenn Ihre Anwendung mit ECMAScript-Modulen entwickelt wurde, richten Sie den Fargate-Collector für „ Node.js “ ein, indem Sie die Schritte im Abschnitt „ECMAScript-Module“ befolgen.

Instana unterstützt derzeit nur die x86_64 Architektur.

curl -s https://icr.io/v2/instana/aws-fargate-nodejs/tags/list | jq .

gyp ERR! ...some error message from trying to rebuild native add-ons, for example:
gyp ERR! stack Error: Could not find any Python installation to use
...
Warning: Rebuilding native add-ons for @instana/fargate failed. Monitoring the Fargate tasks will work nonetheless, but you will miss some Node.js metrics (GC metrics, event loop metrics, ...). See https://www.instana.com/docs/ecosystem/aws-fargate/#build-dependencies-and-native-add-ons for details."

COPY --from=icr.io/instana/aws-fargate-nodejs: latest /instana /instana
RUN apk add --no-cache --virtual .gyp \
        build-base \
        python \
    && /instana/setup.sh \
    && apk del .gyp python
ENV NODE_OPTIONS="--require /instana/node_modules/@instana/aws-fargate"

COPY --from=icr.io/instana/aws-fargate-nodejs:latest /instana /instana
RUN apt-get update \
    && apt-get install build-essential \
    && /instana/setup.sh \
    && apt-get remove -y build-essential
ENV NODE_OPTIONS="--require /instana/node_modules/@instana/aws-fargate"

RUN yum groupinstall "Development Tools"

Die Bereitstellung von „.NET Core “-Tracing in Ihren Fargate-Containern erfolgt genauso wie bei jeder anderen containerisierten Anwendung auf .NET Core. Sie haben zwei Möglichkeiten:

• NuGet -Pakete während der Entwicklung in Ihrer Anwendung installieren
• NuGet -Pakete mithilfe der Dockerfile installieren

Der Fargate-Collector von „ Go “ ist in „ github.com/instana/go-sensor1.14.0 “ und späteren Versionen enthalten. Dieser Collector erfordert keine weitere Konfiguration, abgesehen von der Einrichtung der Umgebungsvariablen, die im Abschnitt „Konfigurieren der Aufgabendefinition“ beschrieben sind. Der Tracer erkennt, dass die Anwendung auf AWS Fargate läuft, und aktiviert den Fargate Collector automatisch.

Der Fargate-Collector von „ Ruby “ ist in „ github.com/instana/ruby-sensor1.197.0 “ und späteren Versionen enthalten. Dieser Collector verwendet die Standardkonfiguration, die im Abschnitt Taskdefinition konfigurieren beschrieben ist. Der Tracer erkennt, dass die Anwendung auf AWS Fargate läuft, und aktiviert den Fargate Collector automatisch.

Der „ Java® “-Fargate-Collector wird über ein „ Docker “-Agent-Image bereitgestellt, das die Collector-Dateien enthält.

Die Docker -Ebene ist in der containers.instana.io -Registry verfügbar. Um die Image-Ebene „ Java “ aus dem Repository „ Docker “ abzurufen, führen Sie die folgenden Schritte aus:

1. Da die Docker -Registry eine Authentifizierung erfordert, melden Sie sich mit Ihrem Agentenschlüssel bei der Registry an, bevor Sie die Registry in Ihrem Docker -Build verwenden:

   docker login -u _ -p <your-agent-key> containers.instana.io
    

   Ersetzen Sie den Platzhalter <your-agent-key> durch Ihren tatsächlichen Instana -Agentenschlüssel auf dem System, auf dem Sie Ihr Docker -Image erstellen.

2. Fügen Sie die folgenden Zeilen zu Ihrer Dockerfile an einer beliebigen Stelle nach der letzten FROM-Klausel hinzu:

   COPY --from=containers.instana.io/instana/release/aws/fargate/jvm:latest /instana /instana
   ENV JAVA_TOOL_OPTIONS="-javaagent:/instana/instana-fargate-collector.jar"
    

3. Erstellen Sie den Container und übertragen Sie ihn mit einer Push-Operation in das von Ihnen ausgewählte Image-Repository.

4. Befolgen Sie die Konfigurationsschritte, die im Abschnitt Taskdefinition konfigurierenbeschrieben sind.

Hinweise:

• Wenn Sie mehrstufige Builds verwenden (d. h., wenn Sie mehrere Klauseln FROM in Ihrem Dockerfilehaben), fügen Sie die folgenden Zeilen in Ihrem Dockerfile nach der letzten Klausel FROM hinzu.

• Die automatische Profilerstellung für „ Java “-Prozesse in „ AWS Fargate “ wird nicht unterstützt.

Der „ Python “-Fargate-Collector ist im Standardpaket „ Instana “ ( Python ) 1.25.0 und in späteren Versionen enthalten. Der Collector erfordert keine weitere Konfiguration, abgesehen von der Einrichtung der Umgebungsvariablen, die im Abschnitt „Konfigurieren der Aufgabendefinition“ beschrieben sind. Das Paket erkennt, dass die Anwendung auf AWS Fargate ausgeführt wird, und aktiviert automatisch den Fargate-Collector.

Der „ PHP “-Fargate-Collector ist in der Tracing-Erweiterung „ Instana “ ( PHP ) enthalten. Um die Erweiterung „ Instana “ einzubinden, fügen Sie die folgenden Zeilen an einer Dockerfile beliebigen Stelle nach der letzten FROM Klausel ein:

RUN --mount=type=secret,id=agent_download_key,env=INSTANA_DOWNLOAD_KEY \
# Download the helper shell script extension to install PHP's extension
    curl https://_:${INSTANA_DOWNLOAD_KEY}@artifact-public.instana.io/artifactory/shared/com/instana/php/instana-ext-download-script/php-instana-ext-download-script.sh \
        -o php-instana-ext-download-script.sh \
    && chmod +x ./php-instana-ext-download-script.sh \
# Running the helper script which downloads the PHP extension
# To check all available options run the shell script without any flags
    && ./php-instana-ext-download-script.sh -p <php version> -d serverless -t <NTS/ZTS> -s <OpenSSL version> \
    && mv ./instana.so $(php -i | sed -nE 's/^extension_dir => (.*) =>.*/\1/p')/instana.so \
# Enable the extension by adding a zzz-instana.ini file
    && echo 'extension=instana.so' > $(php -i | sed -nE 's/.*additional \.ini files => (.*)/\1/p')/zzz-instana.ini
 

Weitere Informationen zum Hilfs-Shell-Skript finden Sie im Abschnitt „Manuelle Installation der Tracing-Erweiterung für PHP “.

Um zu verhindern, dass Ihr Download-Schlüssel für den „ Instana “-Agenten offengelegt wird, übergeben Sie ihn als Build-Geheimnis unter „ Docker “.

Hinweis :

• Wenn Sie das Modul „ PHP “ von „ Apache “ verwenden, stellen Sie die Umgebungsvariablen von „ Instana “ explizit für „ PHP “ bereit. Fügen Sie dazu diese Zeile PassEnv INSTANA_AGENT_KEY INSTANA_ENDPOINT_URL zusammen mit allen anderen Umgebungsvariablen in die Konfigurationsdatei „ Apache “ ein.

• Wenn Sie „ PHP -FPM“ verwenden, das auf bestimmten Basis-Images installiert ist, beispielsweise auf einem offiziellen Basis-Image von Debian oder Ubuntu, müssen Sie entweder in der FPM-Pool-Konfiguration clear_env=no die entsprechende Einstellung vornehmen oder die Umgebungsvariable „ Instana “ explizit zulassen. Offizielle Bilder von „ PHP “ – FPM Docker sind clear_env=no standardmäßig eingestellt. In einigen Basis-Images verfügt „ PHP “ über ein separates Verzeichnis für CLI- und .ini FPM-Dateien. Das richtige Verzeichnis, das hinzugefügt werden muss zzz-instana.ini , lässt sich ermitteln, indem man die Scan this dir for additional .ini files Zeile in der Ausgabe von php-fpm -i, php-fpm8.x -i, oder überprüft, die von PHPphpinfo() -FPM erzeugt wird. Führen Sie „ PHP -FPM“ nicht als Dienst aus. Führen Sie es stattdessen als Daemon oder im Vordergrund aus.

• PHP - Die FPM-Prozessüberwachung, die der Überwachung mit dem PHP -FPM-Sensor ähnelt, wird ebenfalls unterstützt. Siehe „ PHP -FPM-Statusseite aktivieren “.

• Stellen Sie sicher, dass OpenSSL3 oder OpenSSL1.1 im Container „ PHP “ verfügbar ist. OpenSSL3 ist standardmäßig auf vielen Basis-Images installiert, darunter die offiziellen Images von Debian, Ubuntu, Alpine, Amazon Linux und PHP Docker.

• Verwenden Sie den Fargate-Collector unter PHP und die native Tracing-Funktion unter PHP (mit dem Agenten unter Instana ) nicht gleichzeitig, da in einer Laufzeitumgebung von PHP jeweils nur eine Art der Überwachung funktioniert. Damit die native Ablaufverfolgung in einer „ AWS Fargate “-Konfiguration funktioniert, in der der „ Instana “-Agent aktiv ist, stellen Sie sicher, dass die INSTANA_ENDPOINT_URLINSTANA_AGENT_KEY Umgebungsvariablen und der „ PHP “-Laufzeitumgebung nicht zur Verfügung stehen.

Befolgen Sie die Konfigurationsschritte, die im Abschnitt „Aufgabendefinition konfigurieren“ beschrieben sind.