Tüm Ürünler
Search
Belge Merkezi

Application Real-Time Monitoring Service:Diagnose JS errors using ARMS Browser Monitoring

Son Güncelleme:Oct 05, 2026

Üretim ortamındaki JavaScript hatalarının ayıklanması zordur: kod küçültülmüştür (minified) ve her kullanıcının cihazı, tarayıcısı ile ağ koşulları benzersizdir. Çoğu tarayıcı izleme yaklaşımı yalnızca tam sayfa yükleme süresini yakalayan ve statik kaynak yükleme sürelerini dışlayan *PerformanceTiming* nesnesine dayanır; bu durum performans darboğazlarını belirlemeyi zorlaştırır. Application Real-Time Monitoring Service (ARMS) içindeki Tarayıcı İzleme, kaynak haritası (source map) desteğini kullanıcı davranışı geri izleme özelliğiyle birleştirir. Böylece küçültülmüş yığın izlerini (stack traces) kaynak koduna eşleyebilir ve hatayı tetikleyen tam kullanıcı eylemlerini yeniden oynatabilirsiniz.

Ön koşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

Kaynak haritaları nasıl çalışır?

Kaynak haritası, küçültülmüş koddaki konumları orijinal kaynağınızdaki karşılık gelen konumlara eşleyen bir JSON dosyasıdır. Konum verilerini kompakt şekilde saklamak için VLQ kodlamasını kullanır. Kaynak haritası sayesinde Tarayıcı İzleme, "Satır 1, Sütun 79585" konumundaki bir hatayı kaynak kodunuzdaki kesin dosya, satır ve sütun bilgisine dönüştürür.

Teşhis iş akışı

Aşağıdaki iş akışı, uçtan uca süreci adım adım açıklar: hata eğilimlerini belirleme, küçültülmüş yığın izlerini kaynak koduna eşleme ve ardından hatayı tetikleyen kullanıcı eylemlerini yeniden oynatma.

1. Adım: Hata özetini görüntüleyin

  1. ARMS konsolu oturumunu açın.

  2. Sol gezinme bölmesinde Browser Monitoring > Browser Monitoring seçeneğini belirleyin.

  3. Browser Monitoring sayfasında üst gezinti çubuğundan bir bölge seçin ve yönetmek istediğiniz uygulamanın adını tıklayın.

  4. Sol gezinme bölmesinde JS Error Diagnosis öğesini tıklayın.

Bu sayfada:

  • Error Overview bölümü toplam hata sayısını, JS hata oranını ve etkilenen kullanıcıların sayısı ile yüzdesini gösterir.

  • Eğri grafik, zaman içindeki hata eğilimlerini sunar.

  • Frequent Errors sekmesi yüksek frekanslı hataları listeler.

  • Page Ranked by Error Rate ve Error View sekmeleri, hataların sayfalar arasındaki dağılımını gösterir.

2. Adım: Belirli bir hataya odaklanın

İki giriş noktası mevcuttur:

  • Frequent Errors sekmesinde hedef hatanın yanındaki Diagnose düğmesini tıklayın.

  • Eğri grafikte belirli bir zamandaki veri noktasını tıklayarak Exception Insight iletişim kutusunu açın.

Aşağıdaki örnek eğri grafik yaklaşımını kullanır:

  1. Eğri grafikte hata oranının aniden arttığı bir noktayı belirleyin. İmleci kırılma noktasının üzerine getirin; imleç el simgesine dönüştüğünde tıklayın. Exception Insight iletişim kutusu görünür. Daha fazla bilgi için bkz. İstisna içgörüsünü görüntüleme.

  2. Frequent Errors Top 5 sekmesini tıklayın, bir hata seçin ve Operation sütunundaki Diagnose düğmesine tıklayın. Error Detail sekmesi görünür.

3. Adım: Hata ayrıntılarını inceleyin

Hata ayrıntı sayfası aşağıdaki bağlamı sağlar:

Alan Açıklama
İlk oluşum zamanı Hatanın ilk kaydedildiği zaman
İlk oluşum sürümü Hatanın ilk ortaya çıktığı uygulama sürümü (isteğe bağlı)
Hata adı ve türü JavaScript hata adı ve sınıflandırması
Oluşum zamanı Bu hata örneğinin gerçekleştiği zaman
Cihaz, işletim sistemi, tarayıcı Hatanın oluştuğu istemci ortamı
IP adresi, bölge Kullanıcının ağ konumu
Bağlantı türü Ağ bağlantısı (Wi-Fi, 4G vb.)
Hata URL'si Hatanın tetiklendiği sayfa URL'si
Uygulama sürümü Dağıtılan uygulama sürümü
Dosya, satır, sütun Küçültülmüş dosyadaki konum

Örnek: Gerçek zamanlı bir panodaki harita modülünden gelen bir hatayı ele alalım. Modül, bir güncelleme sırasında geçersiz veri bildirdi ve yığın izi küçültülmüş paketin 1. Satır, 79585. Sütununa işaret etti.

Üretim kodu küçültüldüğü için "Satır 1, Sütun 79585" bilgisi doğrudan işlemeye uygun değildir. Bir sonraki adım, bu konumu kaynak kodunuza geri eşler.

4. Adım: Hatayı kaynak koduna eşleyin

Yığın izindeki satır ve sütun numaraları kaynak dosyalarınızı değil, küçültülmüş kodu işaret eder. Orijinal hata konumunu çözmek için bir kaynak haritası uygulayın.

  1. Stack Info bölümünde, bir yığın çerçevesinin solundaki expand icon simgesini tıklayarak çerçeveyi genişletin ve ardından Choose Sourcemap öğesine tıklayın.

  2. Sourcemap File iletişim kutusunda mevcut bir kaynak haritası dosyası seçin veya yeni bir dosya yükleyin, ardından OK düğmesine tıklayın.

    Not

    Aynı anda en fazla beş dosya yükleyebilirsiniz.

  3. Kaynak haritasını uyguladıktan sonra Tarayıcı İzleme, Source Code bölümünde orijinal hata konumunu kırmızı renkle vurgular; böylece hatanın gerçekleştiği tam dosya ve satır görünür. Tam çağrı zincirini izlemek için hata yığınındaki her çerçeveye kaynak haritaları uygulayın.

5. Adım: Kullanıcı davranışı geri izleme ile hatayı yeniden üretin

Kaynak haritası eşlemesi hatanın nerede oluştuğunu ortaya çıkarır ancak her zaman neden oluştuğunu göstermez. Harita modülü örneğinde kaynak kodu eşlemesi, bileşen oluşturma sırasında geçersiz verilerin hataya neden olduğunu gösterir. Ancak kaynak kod zaten bu veriler için null kontrolleri ve hata toleransı içerir. Geçersiz verilerin neden ortaya çıktığını anlamak için hatadan hemen önce neler olduğunu inceleyin.

Tarayıcı İzleme, kullanıcı davranışını kronolojik bir olay düğümleri dizisi olarak kaydeder:

  • Sayfa yükleme

  • Rota değişiklikleri

  • Sayfa tıklamaları

  • API istekleri

  • Konsol çıktıları

Hataya yol açan eylem sırasını yeniden oynatmak için bu izi inceleyin.

Örnek: Aşağıdaki kullanıcı davranışı izinde, hatadan hemen önce bir API isteği gerçekleşmiştir. API çağrısı harita modülü için gerçek zamanlı bir güncelleme istemiş ancak yanıt geçerli harita verileri yerine ConsoleNeedLogin döndürmüştür. Bu durum, kullanıcının sayfadan çıkış yapmış olduğunu; yani geçersiz verinin kök nedenini gösterir.

Kaynak haritaları oluşturma

Teşhis iş akışının 4. Adımı için kaynak haritaları gereklidir. Derleme aracınızla bir kaynak haritası oluşturun ve ardından ARMS konsoluna yükleyin.

Bir kaynak haritası dosyası yüklemek için Browser Monitoring sayfasında uygulamanızı bulun ve Actions sütununda More > Settings seçeneğini belirleyin. Ayarlar sayfasında Advance sekmesini tıklayın.

Webpack

webpack.config.js dosyasında devtool özelliğini "source-map" olarak ayarlayın. Webpack, farklı kaynak haritası türleri için 13 devtool değerini destekler. "source-map" değeri, üretim ortamı hata teşhisi için önerilen eksiksiz ve ayrı bir .map dosyası oluşturur.

const path = require('path');

module.exports = {
    entry: './src/index.js',
    output: {
        filename: 'bundle.js',
        path: path.resolve(__dirname, 'dist')
    },
    devtool: "source-map"
};

Gulp

gulp-sourcemaps paketini kullanın:

var gulp = require('gulp');
var sourcemaps = require('gulp-sourcemaps');

gulp.task('javascript', function() {
    gulp.src('src/**/*.js')
        .pipe(sourcemaps.init())
        .pipe(sourcemaps.write('../sourcemaps'))
        .pipe(gulp.dest('dist'));
});

Grunt

Yalnızca grunt-contrib-uglify ile:

grunt.initConfig({
    uglify: {
        options: {
            sourceMap: true
        }
    }
});

grunt-usemin ile (grunt-contrib-concat ve grunt-contrib-uglify öğelerini çağırır):

grunt.initConfig({
    concat: {
        options: {
            sourceMap: true
        }
    },
    uglify: {
        options: {
            sourceMap: true,
            sourceMapIn: function(uglifySource) {
                return uglifySource + '.map';
            },
        }
    }
});

grunt-jsmin-sourcemap ile:

module.exports = function(grunt) {
    grunt.loadNpmTasks('grunt-jsmin-sourcemap');
    grunt.initConfig({
        'jsmin-sourcemap': {
            all: {
                src: ['scripts/script.js'],
                dest: 'scripts/script.jsmin-grunt.js',
                destMap: 'scripts/script.jsmin-grunt.js.map'
            }
        }
    });
    grunt.registerTask('default', 'jsmin-sourcemap');
};

Angular CLI

ng build --prod --source-map --vendor-source-map

UglifyJS2

UglifyJS2 bir CLI aracıdır. Daha fazla seçenek için bkz. CLI kaynak haritası seçenekleri.

uglifyjs app.js -o app.min.js --source-map app.min.js.map

SystemJS

SystemJS Builder kullanın:

builder.bundle('app.js', 'app-outfile.js', {
    minify: true,
    sourceMaps: true
});