İzleme AWS Fargate

CommonJS

1. Dockerfile ürününüzü, son FROM yantümcesinden sonra herhangi bir yere ekleyin:

   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. Taşıyıcıyı oluşturun ve seçtiğiniz görüntü havuzuna itin.

3. Görev tanımlamasını yapılandırmakısmında açıklanan yapılandırma adımlarını tamamlayın.

ECMAScript modülleri

1. Dockerfile ürününüzü, son FROM yantümcesinden sonra herhangi bir yere ekleyin:

   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. Taşıyıcıyı oluşturun ve seçtiğiniz görüntü havuzuna itin.

3. Görev tanımlamasını yapılandırmakısmında açıklanan yapılandırma adımlarını tamamlayın.

Notlar:

• Çok aşamalı oluşturmalar kullanıyorsanız (yani, Dockerfileiçinde birden çok FROM yantümcesi varsa), bu satırları Dockerfileürününüzdeki son FROM yantümcesinden sonra ekleyin.
• AWS Fargate 'de Node.js işlemlerinin otomatik tanıtımı oluşturma desteklenmez.

Sürüm Oluşturma

icr.io/instana/aws-fargate-nodejs:latest Docker görüntüsü, geçerli ana sürümden bağımsız olarak en son kullanılabilir görüntü sürümünü kullanır. Örneğin, ana sürüm 4 serbest bırakılırsa ve şu anda resim sürümünüz 3 ise, :latestetiketini kullanırsanız, resim bir sonraki yeniden oluşturma işlemi için otomatik olarak sürüm 4 'e güncellenir.

Not: En son görüntü sürümünün kullanılabilir olmasını istemiyorsanız, icr.io/instana/aws-fargate-nodejs:1 (sürüm 1) gibi bir ana görüntü sürümü kullanın ve sonraki ana sürüme el ile güncelleyin.

Daha fazla bilgi için bkz. Node.js sürüm oluşturma.

Bağımlılıklar ve yerel eklentiler oluşturun

Yerel Node.js eklentileri oluşturmak için gerekli paketlere sahip olmayan Node.js kapsayıcılarınız için temel düzey bir görüntü kullanırsanız, Docker oluşturmanızda aşağıdaki uyarıyı görebilirsiniz:

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

Günlük iletisi, Instana 'nın Node.js Fargate görevinizi izlediğini, ancak belirli metrikleri gözden kaçırdığını gösterir. Ölçüm kaybını önlemek için, oluşturma sırasında en azından geçici olarak eksik işletim sistemi paketlerini kurun. Bu paketler son görüntüde hariç tutulabilir. Paketlerin tipi ve nasıl kurulacağı dağıtımınıza bağlıdır.

Linux Alpineiçin aşağıdaki örnek Dockerfile parçacığına bakın:

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"

Debiantabanlı dağıtımlar için aşağıdaki örneğe bakın ( Ubuntudahil):

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 paket yöneticisini kullanan dağıtımlar için ( CentOS ve RHEL gibi), gerekli paketleri kurmak için aşağıdaki komutu çalıştırın:

RUN yum groupinstall "Development Tools"

Node.js katmanının containers.instana.io öğesinden alınması

Docker katmanı, IBM kapsayıcı kayıt defterinde genel olarak bulunur. Node.js Instana Fargate resim katmanını buradan edinebilirsiniz. Diğer bir seçenek olarak, görüntü katmanını containers.instana.io kaydından da edinebilirsiniz. Örneğin, görüntü katmanının yalnızca kimliği doğrulanmış kayıt dosyasında containers.instana.iokullanılabilir olduğu diğer yürütme ortamları (Java ® gibi) ile birlikte Instana Fargate desteğini kullanırsanız ve tutarlılık istiyorsanız, IBM taşıyıcı kaydı yerine containers.instana.io adresinden Node.js görüntü katmanını alabilirsiniz.

Node.js görüntü katmanını containers.instana.io kaydından almak için aşağıdaki adımları tamamlayın:

1. containers.instana.io kayıt dosyası kimlik doğrulaması gerektirdiğinden, Docker oluşturmanızda kullanmadan önce aşağıdaki komutu çalıştırın:

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

   <your-agent-key> yer tutucusunu, Docker görüntünüzü oluşturacağınız sistemdeki Instana aracı anahtarınızla değiştirin.

2. Dockerfile ürününüzü, son FROM yantümcesinden sonra herhangi bir yere ekleyin:

   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"
   

Geliştirme sırasında NuGet paketlerini kurma

Geliştirme sırasında NuGet paketlerini kurmak için, tasarım sırasında projenize yeniden yazıcıya ilişkin NuGet paketlerini ve yönetilen izleme uzantılarını eklemeniz ya da kapsayıcı görüntünüzü hazırlarken oluşturmanın bir parçası olarak aşağıdaki adımları tamamlamanız gerekir:

1. rewriter programının kurulması
2. İzleme paketinin kurulması
3. .NET Core görev tanımlamasını yapılandır

Docker oluşturmasında NuGet paketlerini kurma

NuGet paketlerini bir Docker kapsayıcısına kurmak için aşağıdaki adımları tamamlayın:

1. Alpine Linuxtabanlı bir kapsayıcı görüntüsü kullanıyorsanız, ilk satırı aşağıdaki örnekte olduğu gibi Alpine kullanan uygun NuGet paket postfix ile değiştirin. Tersi durumda Linuxkullanın.

   # 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. Görev tanımlamasını yapılandırmabaşlıklı konuda açıklanan yapılandırma adımlarını izleyin.

Sırları

Java Fargate toplayıcısı, anasistem aracısıgibi sırların soyunmasını destekler.

Güvenlik dizgileri için kalıplar belirtebilirsiniz; yani, veriler izleme ve süreç ayrıntılarından süzülür. Gizli olarak ele alınan veriler, işlenmek üzere SaaS YönOrtamı'naulaşmaz ve bu nedenle, YönOrtamıAna Kullanıcı Arabiriminde ya da API kullanılarak alınamaz.

Güvenlik sırları, INSTANA_SECRETS ortam değişkeni tarafından aşağıdaki biçim kullanılarak tanımlanır:

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

matcher , sağlanan güvenlik sırları için ilgili semantik ile aşağıdaki değerlerden biri olabilir:

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

Herhangi bir güvenlik dizgisi yapılandırılmadıysa, varsayılan bir güvenlik dizgisi kullanılır. Güvenlik dizgisini almak için aşağıdaki ayar etkinleştirilir:

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

Bir anahtar, güvenlik dizgisi listesindeki bir girişle eşleşirse, değer düzeltiilir ve YönOrtamıana arka ucuna gönderilmez.

Altyapı ve platform düzeyinde güvenlik sırları, süreç ortamı değişkenleridir.

Çalıştırma zamanında güvenlik sırları:

• JDBC bağlantı dizgileri
• https://my.domain/accounts/status?account=<secret_1>&user=<secret_2> gibi HTTP sorgu parametreleri (desteklenen tüm çalıştırma zamanları için aşağıdaki destek matrisine bakın)
• https://my.domain/accounts/account=<secret_1>;user=<secret_1>/status gibi HTTP matris yolu parametreleri

Not:

• Instana, bir URL yolundaki isteğe bağlı bölümlerin güvenlik dizgisi olarak kabul edilmesini desteklemez. Örneğin, URL https://my.domain/accounts/<secret>/statusolarak yapılandırıldıysa. Örneğin, bölümlerin atılması için URL yollarındaki düzenli ifadelerin çalıştırılması engelleyici olur.

• Instana, saklanmış yordamlardan SQL değiştirgelerini yakalamamaktadır. Benzer şekilde, isteğe bağlı yol kesimleri için, SQL sorgularından gelen hazır bilgiler soyulmaz; parametreli sorguları kullanın.

Java İzleme SDK

Java Fargate toplayıcısı, aracıya benzer şekilde Java Trace SDK' yı destekler. Ancak, Java Fargate toplayıcısı aracı yapılandırması tarafından değil, INSTANA_INSTRUMENTATION_SDK_PACKAGES ortam değişkeni tarafından etkinleştirilir.

Java İzleme SDK ' nın kullanımına ilişkin ayrıntılı bilgileri belge sayfasındabulabilirsiniz.

INSTANA_INSTRUMENTATION_SDK_PACKAGES , SDK ' nın etkinleştirildiği virgülle ayrılmış Java paketi adlarının bir listesini içerebilir. Örneğin,

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