iOS API

次の表は、設定パラメータの概要を示しています：

次の表は、パフォーマンス設定パラメータの概要を示しています

import InstanaAgent

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
    Instana.setup(key: "<Your Instana Key>", reportingURL: URL(string: "<Your Instana URL>")!)
    ....
    return true
}
 

以下の例に、 HTTP の手動キャプチャ設定を示します。 デフォルト設定を変更するには、以下のコマンドを実行します。

let options = InstanaSetupOptions(httpCaptureConfig: .manual)
Instana.setup(key: <Your Key>, reportingURL: <Your Instana URL>, options: options)
 

let key = Instana.key
let url = Instana.reportingURL
 

let sessionID = Instana.sessionID
 

HTTP のキャプチャを開始する関数。 URLRequest およびオプションのビュー名。 HTTPMarker オブジェクトが返されます。 このオブジェクトは、 HTTP レスポンスの結果を設定するために必要です。

static func startCapture(_ request: URLRequest?, viewName: String? = nil) -> HTTPMarker
 

この関数は、 HTTP メソッドおよび（オプションの）ビュー名に対して URL、 HTTP のキャプチャを開始します。 HTTPMarker オブジェクトが返されます。 このオブジェクトは、後で HTTP レスポンスの結果を設定するために必要になります。

static func startCapture(url: URL, method: String, viewName: String? = nil) -> HTTPMarker
 

応答サイズが決定されたら、 HTTPMarker でこのメソッドを呼び出します。

func set(responseSize: Instana.Types.HTTPSize)
 

以下の初期化指定子を使用して HTTPMarker.Size を作成できます。

init(response: URLResponse, transactionMetrics: [URLSessionTaskTransactionMetrics]?)
 

要求が URLResponse およびオプションの Errorで完了した後、 HTTPMarker で finish を呼び出します。

func finish(response: URLResponse?, error: Error?)
 

あるいは、 HTTPCaptureResult を使用してキャプチャーを終了することもできます。

let size = HTTPMarker.Size(header: 123, body: 1024, bodyAfterDecoding: 2048)
let result = HTTPCaptureResult(statusCode: statusCode, backendTracingID: "Instana-backend-tracing-id", responseSize: size, error: error)
marker.finish(result: result)
 

完了前に要求が取り消された場合は、 HTTPMarker でこのメソッドを呼び出します。 cancelを呼び出すと、状態は「内部的に失敗」に設定され、 NSURLErrorCancelled 状況になります。

func cancel()
 

let marker = Instana.startCapture(request, viewName: "User: Details")
URLSession.shared.dataTask(with: request) { data, response, error in
    marker.finish(response: response, error: error)
}.resume()
 

また、次の例に示すように URLSessionDelegate 、 HTTP のレスポンスサイズを手動で設定することもできます（finishまたはcancelを呼び出す前）

func urlSession(_ session: URLSession, task: URLSessionTask, didFinishCollecting metrics: URLSessionTaskMetrics) {
    guard let response = task.response else { return }
    marker.set(responseSize: HTTPMarker.Size(response: response, transactionMetrics: metrics.transactionMetrics))
}
 

let url = URL(string: "https://www.example.com/user/123/details")!
let marker = Instana.startCapture(url: url, method: "GET", viewName: "Home")
YourNetworkManager(url: url, method: "GET") { (statusCode, error) in
    let size = HTTPMarker.Size(header: 123, body: 1024, bodyAfterDecoding: 2048) // optionally
    let backendTracingID = "Instana-backend-tracing-id" // optionally
    let result = HTTPCaptureResult(statusCode: statusCode, backendTracingID: backendTracingID, responseSize: size, error: error)
    marker.finish(result: result)
}.resume()
 

次の表は、設定パラメータの概要を示しています：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    Instana.setView(name: "User: Details")
}
 

現在のビュー名を取得するには、クラス変数 viewNameを使用できます。 ビュー名の値は、アプリケーションの状態に応じて、Inactive または Background のいずれかになります。

let viewName = Instana.viewName
 

次の表は、設定パラメータの概要を示しています：

設定しない値には nil を渡すことができます。

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
     Instana.setup(key: InstanaKey, reportingURL: InstanaURL)
     Instana.setUser(id: someID, email: "email@example.com", name: "John")
     return true
}
 

別の方法として、ユーザー・プロパティーを個別に設定することもできます。

ユーザー ID を設定します。

static func setUser(id: String)
 

ユーザーの E メール・アドレスを設定します。

static func setUser(email: String)
 

ユーザー名を設定します。

static func setUser(name: String)
 

以下の表にパラメータの概要を示します：

以下の表にパラメータの概要を示します：

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    Instana.setup(key: InstanaKey, reportingURL: InstanaURL)
    Instana.setMeta(value: "ReactNative", key: "Platform")
    Instana.setMeta(value: "DEBUG", key: "Environment")
    return true
}
 

次の表は、設定パラメータの概要を示しています：

let session = URLSession(configuration: .default)
Instana.ignore(session)
 

次の表は、設定パラメータの概要を示しています：

let regex = try! NSRegularExpression(pattern: "/.*(&|\?)password=.*/i")
Instana.setIgnoreURLs(matching: [regex])
 

この例では、クエリにパスワードが含まれるすべてのURLが無視されます。

あるいは、以下の例のような完全な URL を無視することもできます。

Instana.setIgnore(urls: [URL(string: "https://www.example.com")!])
 

次の表は、設定パラメータの概要を示しています：

Instana.reportEvent(name: "Event-Name")
Instana.reportEvent(name: "Event-Name", viewName: "User: Details")
Instana.reportEvent(name: "Event-Name", timestamp: 1590149955086, duration: 124842, backendTracingID: "some-id", error: NSError(domain: "Some", code: -1, userInfo: nil), meta: ["Key": "Value"], viewName: "User: Details")
Instana.reportEvent(name: "Event-Name", customMetric: 1234.567)
 

Instana.collectionEnabled = true
 

次の表は、設定パラメータの概要を示しています：

let regex = try! NSRegularExpression(pattern: #"pass(word|wort)"#)
Instana.redactHTTPQuery(matching: [regex])
 

この例では、 HTTP パラメータのキー「password」または「passwort」の値は伏せられています。 キャプチャされた URL は収集され、次 https://example.com/accounts/?password=123&passwort=459 のように表示 https://example.com/accounts/?password=<redacted>&passwort=<redacted>されます。

次の表は、設定パラメータの概要を示しています：

let regex = try! NSRegularExpression(pattern: #"X-Key"#, options: [.caseInsensitive])
Instana.setCaptureHeaders(matching: [regex])
 

この例では、キーが X-Key または である X-KEYHTTP ヘッダーフィールドを示しています。

import InstanaAgent
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
    let options = InstanaSetupOptions(slowSendInterval: 60.0)
    if !Instana.setup(key: InstanaKey, reportingURL: InstanaURL, options: options) {
        // Error handling here
    }
    ....
    return true
}
 

import InstanaAgent
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
    let options = InstanaSetupOptions(usiRefreshTimeIntervalInHrs: 24.0)
    if !Instana.setup(key: InstanaKey, reportingURL: InstanaURL, options: options) {
        // Error handling here
    }
    ....
    return true
}