String koneksi

Gambaran Umum

String koneksi menentukan tempat mengirim data telemetri.

Pasangan nilai kunci memberikan cara mudah bagi pengguna untuk menentukan kombinasi akhiran awalan untuk setiap layanan/produk Application Insights (AI).

Catatan

Pada tanggal 31 Maret 2025, dukungan untuk penyerapan kunci instrumentasi akan berakhir. Penyerapan kunci instrumentasi akan berjalan terus, tetapi kami tidak akan lagi menyediakan pembaruan atau dukungan terhadap fitur tersebut. Transisi ke string koneksi untuk memanfaatkan kemampuan baru.

Penting

Jangan gunakan string koneksi dan kunci instrumentasi secara bersamaan. Apa pun yang ditetapkan terakhir akan didahulukan.

Ringkasan skenario

Skenario yang paling terpengaruh oleh perubahan ini:

• Pengecualian firewall atau pengalihan proksi

  Dalam kasus saat pemantauan untuk server web intranet diperlukan, solusi kami sebelumnya meminta pelanggan menambahkan titik akhir layanan individual ke konfigurasi Anda. Untuk informasi selengkapnya, lihat di sini. String koneksi menawarkan alternatif yang lebih baik dengan mengurangi upaya ini ke satu pengaturan. Awalan sederhana, amandemen akhiran memungkinkan populasi otomatis dan pengalihan semua titik akhir ke layanan yang tepat.

• Lingkungan cloud Sovereign atau Hybrid

  Pengguna dapat mengirim data ke Wilayah Azure Government yang ditentukan. String koneksi memungkinkan Anda menentukan pengaturan titik akhir untuk server intranet atau pengaturan cloud hibrid.

Memulai

Menemukan string koneksi saya?

String koneksi Anda ditampilkan di bagian Ringkasan dari sumber daya Application Insights Anda.

Skema

Panjang maksimum

Koneksi ini memiliki panjang maksimum yang didukung, yaitu 4096 karakter.

Pasangan kunci-nilai

String koneksi terdiri dari daftar pengaturan yang dinyatakan sebagai pasangan nilai kunci yang dipisahkan oleh titik koma: key1=value1;key2=value2;key3=value3

Sintaks

• InstrumentationKey (misalnya: 00000000-0000-0000-0000-000000000000) String koneksi adalah bidang wajib diisi.
• Authorization (misalnya: ikey) (Pengaturan ini opsional karena hari ini kami hanya mendukung otorisasi ikey.)
• EndpointSuffix (misalnya: applicationinsights.azure.cn) Mengatur akhiran titik akhir akan menginstruksikan SDK tempat cloud Azure tersambung. SDK akan merakit sisa titik akhir untuk layanan individu.
• Titik Akhir Eksplisit. Layanan apa pun dapat secara eksplisit ditimpa dalam string koneksi.
  • IngestionEndpoint (misalnya: https://dc.applicationinsights.azure.com)
  • LiveEndpoint (misalnya: https://live.applicationinsights.azure.com)
  • ProfilerEndpoint (misalnya: https://profiler.monitor.azure.com)
  • SnapshotEndpoint (misalnya: https://snapshot.monitor.azure.com)

Skema titik akhir

<prefix>.<suffix>

• Awalan: Mendefinisikan layanan.
• Akhiran: Mendefinisikan nama domain umum.

Akhiran yang valid

Berikut adalah daftar akhiran yang valid

• applicationinsights.azure.cn
• applicationinsights.us

Lihat juga: Wilayah yang memerlukan modifikasi titik akhir

Awalan yang valid

• Penyerapan Telemetri: dc
• Metrik Langsung: live
• Profiler: profiler
• Rekam jepret: snapshot

Contoh string koneksi

String koneksi dengan akhiran titik akhir

InstrumentationKey=00000000-0000-0000-0000-000000000000;EndpointSuffix=ai.contoso.com;

Dalam contoh ini, string koneksi menentukan sufiks titik akhir dan SDK akan membuat titik akhir layanan.

• Default skema otorisasi ke "ikey"
• Kunci Instrumentasi: 00000000-0000-0000-0000-000000000000
• URI layanan regional didasarkan pada akhiran titik akhir yang disediakan:
  • Penyerapan: https://dc.ai.contoso.com
  • Metrik langsung: https://live.ai.contoso.com
  • Profiler: https://profiler.ai.contoso.com
  • Debugger: https://snapshot.ai.contoso.com

String koneksi dengan penggantian titik akhir eksplisit

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://custom.com:111/;LiveEndpoint=https://custom.com:222/;ProfilerEndpoint=https://custom.com:333/;SnapshotEndpoint=https://custom.com:444/;

Dalam contoh ini, string koneksi menentukan pengambilalihan eksplisit untuk setiap layanan. SDK akan menggunakan titik akhir yang tepat yang disediakan tanpa modifikasi.

• Default skema otorisasi ke "ikey"
• Kunci Instrumentasi: 00000000-0000-0000-0000-000000000000
• URI layanan regional didasarkan pada nilai penggantian yang eksplisit:
  • Penyerapan: https://custom.com:111/
  • Metrik langsung: https://custom.com:222/
  • Profiler: https://custom.com:333/
  • Debugger: https://custom.com:444/

String koneksi dengan wilayah eksplisit

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://southcentralus.in.applicationinsights.azure.com/

Dalam contoh ini, string koneksi menentukan wilayah US Tengah Selatan.

• Default skema otorisasi ke "ikey"
• Kunci Instrumentasi: 00000000-0000-0000-0000-000000000000
• URI layanan regional didasarkan pada nilai penggantian yang eksplisit:
  • Penyerapan: https://southcentralus.in.applicationinsights.azure.com/

Jalankan perintah berikut di Azure Command-Line Interface (CLI) untuk membuat daftar wilayah yang tersedia.

az account list-locations -o table

Cara mengatur string koneksi

String Koneksi didukung dalam versi SDK berikut:

• .NET v2.12.0
• Java v2.5.1 dan Java 3.0
• JavaScript v2.3.0
• NodeJS v1.5.0
• Python v1.0.0

String koneksi dapat diatur dengan baik dalam kode, variabel lingkungan, atau file konfigurasi.

Variabel lingkungan

• String Koneksi: APPLICATIONINSIGHTS_CONNECTION_STRING

Sampel kode

.NET/.NetCore

Atur properti TelemetryConfiguration.ConnectionString atau ApplicationInsightsServiceOptions.ConnectionString

.NET Secara Eksplisit Mengatur:

var configuration = new TelemetryConfiguration
{
    ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000;"
};

File Konfigurasi .NET:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
    <ConnectionString>InstrumentationKey=00000000-0000-0000-0000-000000000000</ConnectionString>
</ApplicationInsights>

.NET Secara Eksplisit Mengatur:

public void ConfigureServices(IServiceCollection services)
{
    var options = new ApplicationInsightsServiceOptions { ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000;" };
    services.AddApplicationInsightsTelemetry(options: options);
}

.NET Core config.json:

{
  "ApplicationInsights": {
    "ConnectionString" : "InstrumentationKey=00000000-0000-0000-0000-000000000000;"
    }
  }

Java

Anda dapat mengatur string koneksi di file konfigurasi applicationinsights.json:

{
  "connectionString": "InstrumentationKey=00000000-0000-0000-0000-000000000000"
}

Untuk informasi selengkapnya, konfigurasi string koneksi.

Untuk Application Insights Java 2.x, Anda dapat mengatur string koneksi dalam file konfigurasi ApplicationInsights.xml:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
    <ConnectionString>InstrumentationKey=00000000-0000-0000-0000-000000000000</ConnectionString>
</ApplicationInsights>

JavaScript

Penting: JavaScript tidak mendukung penggunaan Variabel Lingkungan.

Menggunakan cuplikan:

Cuplikan saat ini (tercantum di bawah) adalah versi "5", versi dikodekan dalam cuplikan sebagai sv:"#" dan versi saat ini juga tersedia di GitHub.

<script type="text/javascript">
!function(T,l,y){var S=T.location,k="script",D="instrumentationKey",C="ingestionendpoint",I="disableExceptionTracking",E="ai.device.",b="toLowerCase",w="crossOrigin",N="POST",e="appInsightsSDK",t=y.name||"appInsights";(y.name||T[e])&&(T[e]=t);var n=T[t]||function(d){var g=!1,f=!1,m={initialize:!0,queue:[],sv:"5",version:2,config:d};function v(e,t){var n={},a="Browser";return n[E+"id"]=a[b](),n[E+"type"]=a,n["ai.operation.name"]=S&&S.pathname||"_unknown_",n["ai.internal.sdkVersion"]="javascript:snippet_"+(m.sv||m.version),{time:function(){var e=new Date;function t(e){var t=""+e;return 1===t.length&&(t="0"+t),t}return e.getUTCFullYear()+"-"+t(1+e.getUTCMonth())+"-"+t(e.getUTCDate())+"T"+t(e.getUTCHours())+":"+t(e.getUTCMinutes())+":"+t(e.getUTCSeconds())+"."+((e.getUTCMilliseconds()/1e3).toFixed(3)+"").slice(2,5)+"Z"}(),iKey:e,name:"Microsoft.ApplicationInsights."+e.replace(/-/g,"")+"."+t,sampleRate:100,tags:n,data:{baseData:{ver:2}}}}var h=d.url||y.src;if(h){function a(e){var t,n,a,i,r,o,s,c,u,p,l;g=!0,m.queue=[],f||(f=!0,t=h,s=function(){var e={},t=d.connectionString;if(t)for(var n=t.split(";"),a=0;a<n.length;a++){var i=n[a].split("=");2===i.length&&(e[i[0][b]()]=i[1])}if(!e[C]){var r=e.endpointsuffix,o=r?e.location:null;e[C]="https://"+(o?o+".":"")+"dc."+(r||"services.visualstudio.com")}return e}(),c=s[D]||d[D]||"",u=s[C],p=u?u+"/v2/track":d.endpointUrl,(l=[]).push((n="SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details)",a=t,i=p,(o=(r=v(c,"Exception")).data).baseType="ExceptionData",o.baseData.exceptions=[{typeName:"SDKLoadFailed",message:n.replace(/\./g,"-"),hasFullStack:!1,stack:n+"\nSnippet failed to load ["+a+"] -- Telemetry is disabled\nHelp Link: https://go.microsoft.com/fwlink/?linkid=2128109\nHost: "+(S&&S.pathname||"_unknown_")+"\nEndpoint: "+i,parsedStack:[]}],r)),l.push(function(e,t,n,a){var i=v(c,"Message"),r=i.data;r.baseType="MessageData";var o=r.baseData;return o.message='AI (Internal): 99 message:"'+("SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details) ("+n+")").replace(/\"/g,"")+'"',o.properties={endpoint:a},i}(0,0,t,p)),function(e,t){if(JSON){var n=T.fetch;if(n&&!y.useXhr)n(t,{method:N,body:JSON.stringify(e),mode:"cors"});else if(XMLHttpRequest){var a=new XMLHttpRequest;a.open(N,t),a.setRequestHeader("Content-type","application/json"),a.send(JSON.stringify(e))}}}(l,p))}function i(e,t){f||setTimeout(function(){!t&&m.core||a()},500)}var e=function(){var n=l.createElement(k);n.src=h;var e=y[w];return!e&&""!==e||"undefined"==n[w]||(n[w]=e),n.onload=i,n.onerror=a,n.onreadystatechange=function(e,t){"loaded"!==n.readyState&&"complete"!==n.readyState||i(0,t)},n}();y.ld<0?l.getElementsByTagName("head")[0].appendChild(e):setTimeout(function(){l.getElementsByTagName(k)[0].parentNode.appendChild(e)},y.ld||0)}try{m.cookie=l.cookie}catch(p){}function t(e){for(;e.length;)!function(t){m[t]=function(){var e=arguments;g||m.queue.push(function(){m[t].apply(m,e)})}}(e.pop())}var n="track",r="TrackPage",o="TrackEvent";t([n+"Event",n+"PageView",n+"Exception",n+"Trace",n+"DependencyData",n+"Metric",n+"PageViewPerformance","start"+r,"stop"+r,"start"+o,"stop"+o,"addTelemetryInitializer","setAuthenticatedUserContext","clearAuthenticatedUserContext","flush"]),m.SeverityLevel={Verbose:0,Information:1,Warning:2,Error:3,Critical:4};var s=(d.extensionConfig||{}).ApplicationInsightsAnalytics||{};if(!0!==d[I]&&!0!==s[I]){var c="onerror";t(["_"+c]);var u=T[c];T[c]=function(e,t,n,a,i){var r=u&&u(e,t,n,a,i);return!0!==r&&m["_"+c]({message:e,url:t,lineNumber:n,columnNumber:a,error:i}),r},d.autoExceptionInstrumented=!0}return m}(y.cfg);function a(){y.onInit&&y.onInit(n)}(T[t]=n).queue&&0===n.queue.length?(n.queue.push(a),n.trackPageView({})):a()}(window,document,{
src: "https://js.monitor.azure.com/scripts/b/ai.2.min.js", // The SDK URL Source
// name: "appInsights", // Global SDK Instance name defaults to "appInsights" when not supplied
// ld: 0, // Defines the load delay (in ms) before attempting to load the sdk. -1 = block page load and add to head. (default) = 0ms load after timeout,
// useXhr: 1, // Use XHR instead of fetch to report failures (if available),
crossOrigin: "anonymous", // When supplied this will add the provided value as the cross origin attribute on the script tag
// onInit: null, // Once the application insights instance has loaded and initialized this callback function will be called with 1 argument -- the sdk instance (DO NOT ADD anything to the sdk.queue -- As they won't get called)
cfg: { // Application Insights Configuration
  connectionString:"InstrumentationKey=00000000-0000-0000-0000-000000000000;"
}});
</script>

Catatan

Untuk keterbacaan dan untuk mengurangi kemungkinan kesalahan JavaScript, semua opsi konfigurasi yang memungkinkan tercantum pada baris baru dalam kode cuplikan di atas, jika Anda tidak ingin mengubah nilai baris yang dikomentari, nilai tersebut dapat dihapus.

Penyiapan Manual:

import { ApplicationInsights } from '@microsoft/applicationinsights-web'

const appInsights = new ApplicationInsights({ config: {
  connectionString: 'InstrumentationKey=00000000-0000-0000-0000-000000000000;'
  /* ...Other Configuration Options... */
} });
appInsights.loadAppInsights();
appInsights.trackPageView();

Node.js

const appInsights = require("applicationinsights");
appInsights.setup("InstrumentationKey=00000000-0000-0000-0000-000000000000;");
appInsights.start();

Python

Kami menyarankan pengguna mengatur variabel lingkungan.

Untuk mengatur string koneksi secara eksplisit:

from opencensus.ext.azure.trace_exporter import AzureExporter
from opencensus.trace.samplers import ProbabilitySampler
from opencensus.trace.tracer import Tracer

tracer = Tracer(exporter=AzureExporter(connection_string='InstrumentationKey=00000000-0000-0000-0000-000000000000'), sampler=ProbabilitySampler(1.0))

Langkah berikutnya

Mulai pada runtime dengan:

• Aplikasi yang di-hosting IIS set skala komputer virtual Azure dan Azure VM
• Server IIS
• Azure Web Apps

Mulai pada waktu pengembangan dengan:

• ASP.NET
• Inti ASP.NET
• Java
• Node.js
• Python