監視 AWS Fargate

CommonJS

1. 將下列行新增至 Dockerfile 最後一個 FROM 子句之後的任何位置:

   COPY --from=icr.io/instana/aws-fargate-nodejs:latest /instana /instana
   RUN /instana/setup.sh
   ENV NODE_OPTIONS="--require /instana/node_modules/@instana/aws-fargate"
   

2. 建置容器，並將它推送至您選擇的映像檔儲存庫。

3. 完成 配置作業定義中說明的配置步驟。

ECMAScript 模組

1. 將下列行新增至 Dockerfile 最後一個 FROM 子句之後的任何位置:

   COPY --from=icr.io/instana/aws-fargate-nodejs:latest /instana /instana
   RUN /instana/setup.sh
   ENV NODE_OPTIONS="--experimental-loader=/instana/node_modules/@instana/aws-fargate/esm-loader.mjs"
   

2. 建置容器，並將它推送至您選擇的映像檔儲存庫。

3. 完成 配置作業定義中說明的配置步驟。

附註：

• 如果您使用 多階段建置 (亦即，如果 Dockerfile中有多個 FROM 子句) ，請在 Dockerfile的最後一個 FROM 子句之後新增這些行。
• 不支援 AWS Fargate 中 Node.js 程序的 自動側寫 。

版本化

不論現行主要版本為何， icr.io/instana/aws-fargate-nodejs:latest Docker 映像檔都會使用最新可用的映像檔版本。 例如，如果已發行主要版本 4 ，且目前您的映像檔版本是 3 ，則在下一次重建時，如果您使用標籤 :latest，則映像檔會自動更新為第 4 版。

附註: 如果您不想要最新映像檔版本可用，請使用主要映像檔版本 (例如 icr.io/instana/aws-fargate-nodejs:1 (第 1 版)) ，並手動更新至下一個主要版本。

如需相關資訊，請參閱 Node.js 版本化。

建置相依關係和原生附加程式

如果您對 Node.js 容器使用最小基本映像檔 (沒有建置原生 Node.js 附加程式所需的套件) ，您可以在 Docker 建置中看到下列警告:

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."

日誌訊息暗示 Instana 會監視您的 Node.js Fargate 作業，但它可能遺失某些度量值。 為了避免失去度量值，請在建置期間至少暫時安裝遺漏的作業系統套件。 這些套件可以在最終映像檔中排除。 套件類型及安裝方式視您的發行套件而定。

請參閱下列適用於 Linux Alpine的範例 Dockerfile Snippet:

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"

請參閱下列基於 Debian的發行套件範例 (包括 Ubuntu):

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"

對於使用 yum 套件管理程式 (例如 CentOS 和 RHEL) 的發行套件，請執行下列指令來安裝必要的套件:

RUN yum groupinstall "Development Tools"

從 containers.instana.io 取得 Node.js 層

Docker 層在 IBM 儲存器登錄上公開可用。 您可以從它取得 Node.js Instana Fargate 映像檔層。 或者，您也可以從 containers.instana.io 登錄取得映像檔層。 例如，如果您也搭配使用 Instana Fargate 支援與其他執行時期 (例如 Java ®) ，且映像檔層只適用於已鑑別登錄 containers.instana.io，且您想要一致性，則可以從 containers.instana.io 而非 IBM 容器登錄取得 Node.js 映像檔層。

若要從 containers.instana.io 登錄取得 Node.js 映像檔層，請完成下列步驟:

1. 因為 containers.instana.io 登錄需要鑑別，所以在 Docker 建置中使用它之前，請先執行下列指令:

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

   將位置保留元 <your-agent-key> 取代為您建置 Docker 映像檔所在系統上的 Instana 代理程式金鑰。

2. 將下列行新增至 Dockerfile 最後一個 FROM 子句之後的任何位置:

   COPY --from=containers.instana.io/instana/release/aws/fargate/nodejs:latest /instana /instana
   RUN /instana/setup.sh
   ENV NODE_OPTIONS="--require /instana/node_modules/@instana/aws-fargate"
   

在開發期間安裝 NuGet 套件

若要在開發期間安裝 NuGet 套件，您必須在設計時將重新編寫程式及受管理追蹤延伸的 NuGet 套件新增至專案，或在準備容器映像檔時完成下列步驟作為建置的一部分:

1. 安裝重新編寫程式
2. 安裝追蹤套件
3. 配置 .NET Core 作業定義

在 Docker 建置中安裝 NuGet 套件

若要在 Docker 容器中安裝 NuGet 套件，請完成下列步驟:

1. 如果您使用以 Alpine Linux為基礎的容器映像檔，請將第一行取代為使用 Alpine 的適當 NuGet 套件字尾，如下列範例所示。 否則，請使用 Linux。

   # after building the project, right before publishing, add the nuget-packages
   RUN dotnet add <project_name>.csproj package Instana.Tracing.Core.Rewriter.<Linux|Alpine> --version <min-version 1.0.56>
   RUN dotnet add <project_name>.csproj package Instana.Tracing.Core --version <min-version 1.1.46>
   RUN dotnet publish -c Release -o out
   
   # where the files will end up
   WORKDIR /app
   COPY --from=publish /src/out .
   
   # set the env-vars as discussed above
   ENV CORECLR_ENABLE_PROFILING=1
   ENV CORECLR_PROFILER={cf0d821e-299b-5307-a3d8-b283c03916dd}
   ENV CORECLR_PROFILER_PATH=/app/instana_tracing/CoreProfiler.so
   ENV DOTNET_STARTUP_HOOKS=/app/Instana.Tracing.Core.dll
   
   ... # Other stuff in your Docker image
   

2. 遵循 配置作業定義中說明的配置步驟。

密鑰

Java Fargate 收集器支援刪除密鑰，類似於 主機代理程式。

您可以指定密鑰的型樣，即從追蹤及處理程序詳細資料中過濾資料。 視為密鑰的資料不會到達 Instana SaaS 進行處理，因此無法在 Instana 使用者介面中進行分析或使用 API 進行擷取。

密鑰由環境變數 INSTANA_SECRETS 使用下列格式來定義:

<matcher>:<secret>[,<secret>]

matcher 可以是下列其中一個值，並具有所提供密鑰的個別語意:

equals-ignore-case, equals, contains-ignore-case, contains, regex

如果未配置任何密鑰，則會使用預設密鑰。 已啟用下列設定來取得密鑰:

INSTANA_SECRETS=contains-ignore-case:key,password,secret

如果金鑰符合密鑰清單中的項目，則會編寫該值，且不會傳送至 Instana 後端。

基礎架構和平台層次的密碼是程序環境變數。

執行時期的密鑰:

• JDBC 連線字串
• HTTP 查詢參數，例如 https://my.domain/accounts/status?account=<secret_1>&user=<secret_2> (針對所有支援的執行時期，請參閱下列支援矩陣)
• HTTP 矩陣路徑參數，例如 https://my.domain/accounts/account=<secret_1>;user=<secret_1>/status

附註：

• Instana 不支援將 URL 路徑中的任意區段視為密碼。 例如，如果 URL 結構化為 https://my.domain/accounts/<secret>/status。 例如，在 URL 路徑上執行正規表示式以捨棄區段的額外負擔是令人難以負擔的。

• Instana 不會從儲存程序擷取 SQL 參數。 同樣地，對於任意路徑區段，不會刪除 SQL 查詢中的文字; 請使用參數化查詢。

Java 追蹤 SDK

Java Fargate 收集器支援 Java 追蹤 SDK，類似於代理程式。 不過， Java Fargate 收集器由環境變數 INSTANA_INSTRUMENTATION_SDK_PACKAGES 啟動，而不是由代理程式配置啟動。

有關使用 Java 追蹤 SDK 的詳細資訊，請參閱其 說明文件頁面。

INSTANA_INSTRUMENTATION_SDK_PACKAGES 可以包含已啟動 SDK 的 Java 套件名稱清單 (以逗點區隔)。 例如，

INSTANA_INSTRUMENTATION_SDK_PACKAGES=my.first.package,my.second.package