コンテンツにスキップ

macOS アプリケーションの接続


Guance アプリケーションモニタリングは、各 macOS アプリケーションのメトリクスデータを収集し、各 macOS アプリケーション側のパフォーマンスを可視化して分析できます。

参照順序

前提条件

注意

RUM Headless サービスを有効化している場合、前提条件は自動的に設定されるため、アプリケーションに直接接続できます。

ローカル環境でデプロイする場合は、以下のデータ受信側の設定を完了する必要があります。パブリックネットワークの DataWay を使用する場合、DataKit を自分でデプロイする必要はありません。

アプリケーションの接続

  1. RUM > アプリケーションを作成 > macOS に移動します
  2. アプリケーション名を入力します
  3. アプリケーション ID を入力します
  4. 「接続方法を選択」で Agent 自動接続または手動接続を選択し、「接続設定」を完了します

接続方法を選択

アプリケーション設定ページで「Agent 自動接続」または「手動接続」を選択し、「接続設定」を完了します。既存のアプリケーションの場合は、設定ページに直接移動して接続を続行できます。

接続方法 ユースケース 操作入口
Agent 自動接続 コーディングアシスタントにプロジェクトを分析させ、SDK の接続を完了させたい場合 コンソールで生成されたプロンプトをコピーし、アプリケーションのコードリポジトリでコーディングアシスタントに渡して実行します
手動接続 SDK を自分でインストールしてパラメータを設定したい場合 データ送信方法を確認し、本文とクイックスタートに従って設定を完了します

Agent 自動接続

  1. 現在のアプリケーションの設定ページで「Agent 自動接続」を選択します。
  2. 「接続設定」内のプロンプト全体をコピーします。現在のアプリケーションの接続情報が使用されていることを確認してください。
  3. アプリケーションのコードリポジトリでコーディングアシスタントを開き、プロンプトを貼り付けます。Agent が接続ガイドに従ってプロジェクトを分析し、SDK の設定を完了します。
  4. アプリケーションをビルドして実行し、ページアクセスなどの操作を発生させ、現在のアプリケーションのエクスプローラーでデータが受信されていることを確認します。

ページに個人用 API Key または一時認証コードが未準備である旨が表示された場合は、案内に従って補完してからプロンプトを再度コピーしてください。

手動接続

アプリケーション設定ページで「手動接続」を選択し、データ送信方法を確認します。

  • パブリックネットワーク DataWay:RUM データを直接受信します。DataKit コレクターをインストールする必要はありません。
  • ローカル環境デプロイ:前提条件を満たしたうえで RUM データを受信します。

後述のインストールとクイックスタートに従って、SDK のインストール、初期化、検証を完了してください。既存の SDK 設定がある場合は、まず内容を確認して再利用し、重複した初期化を避けてください。

インストール

ソースコード:https://github.com/GuanceCloud/datakit-macos

Demo:https://github.com/GuanceCloud/datakit-macos/Example

  1. Podfile ファイルを設定します。
   target 'yourProjectName' do

   # Pods for your project
   pod 'FTMacOSSDK', '~>[latest_version]'

   end
  1. Podfile のディレクトリで pod install を実行して SDK をインストールします。
  1. PROJECT -> Package Dependency を選択し、Packages 欄の + をクリックします。

  2. 表示されたページの検索ボックスに https://github.com/GuanceCloud/datakit-macos を入力します。これはコードの保存場所です。

  3. Xcode がパッケージの取得に成功すると、SDK の設定ページが表示されます。

Dependency Rule:Up to Next Major Version を選択することを推奨します。

Add To Project:サポート対象のプロジェクトを選択します。

設定を入力したら Add Package ボタンをクリックし、読み込みが完了するまで待ちます。

  1. Choose Package Products for datakit-macos ダイアログで SDK を追加する Target を選択し、Add Package ボタンをクリックすると、SDK の追加が完了します。

プロジェクトが SPM で管理されている場合は、FTMacOSSDK を依存関係として追加し、dependencies を Package.swift に追加します。

```swift dependencies: [

.package(url: "https://github.com/GuanceCloud/datakit-macos.git", .upToNextMajor(from: "[latest_version]")) ] ```

ヘッダーファイルの追加

#import "FTMacOSSDK.h"
import FTMacOSSDK

詳細設定の入口

高度なシナリオ

よくある質問

クラッシュログの分析について

クラッシュログの分析と dSYM の説明については、トラブルシューティングを参照してください。

「Include of non-modular header inside framework module」エラーが発生する

SDK の .h ファイルで依存ライブラリの .h ファイルをインクルードしているため、次の設定が必要です。

Target -> Build Settings -> CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES を YES に設定します。

フィードバック

このページは役に立ちましたか?