ラベル APM の投稿を表示しています。 すべての投稿を表示
ラベル APM の投稿を表示しています。 すべての投稿を表示

2026年4月30日木曜日

Microsoft APMのapm.ymlにOracle Databaseのスキルを含める

Oracle Corporationが公開しているGitHubのリポジトリに、skillsが含まれています。

https://github.com/oracle/skills

SkillsはできるだけMicrosoft APM(Agent Package Manager)で管理したいので、上記で公開されているOracleのスキルをapm.ymlに追加する方法を確認しました。

Git管理下のスキルはdependenciesのapmに、以下のように追加します。(Example: apm.ymlに記載されています)。
dependencies:
  apm:
    # Oracle Database Skills
    - git: https://github.com/oracle/skills
      path: db
      ref: main
refにはブランチ名、タグ、コミット、完全なSHAの値のどれかを指定できます。

2026年4月30日現在では、指定できるパスとしてはapex、db、fusion、graal、ociの5つがありますが、dbとgraalを除くと、以下の内容のSKILL.mdがあるだけのようです。
# Oracle Cloud Infrastructure Skills

This file is a sample domain skeleton.

For the repo-wide structure and authoring pattern, read the root `README.md` and `SKILL_AUTHORING_GUIDE.md`.
dependenciesのapmにOracle Databaseのスキルを追加して、それぞれインストールしてみます。

OpenCode向けにインストールします。

apm install --only apm --target opencode --force

% apm install --only apm --target opencode --force

[>] Installing dependencies from apm.yml...

  [+] github.com/oracle/skills/db#main #main @66074f9d (cached)

  |-- Skill integrated -> .opencode/skills/


  [+] <project root> (local)

  |-- 4 skill(s) integrated -> .opencode/skills/


[*] Installed 2 APM dependencies.

% ls .opencode/skills/db

admin architecture devops migrations performance SKILL.md

agent containers features monitoring plsql sql-dev

appdev design frameworks ords security sqlcl

% 


Claude Code向けにインストールします。

apm install --only apm --target claude --force

% apm install --only apm --target claude --force

[>] Installing dependencies from apm.yml...

  [+] github.com/oracle/skills/db#main #main @66074f9d (cached)

  |-- Skill integrated -> .claude/skills/


  [+] <project root> (local)

  |-- 1 rule(s) integrated -> .claude/rules/

  |-- 4 skill(s) integrated -> .claude/skills/


[*] Installed 2 APM dependencies.

% ls .claude/skills/db

admin architecture devops migrations performance SKILL.md

agent containers features monitoring plsql sql-dev

appdev design frameworks ords security sqlcl

% 


Codex向けにインストールします。

apm install --only apm --target codex --force

% apm install --only apm --target codex --force 

[>] Installing dependencies from apm.yml...

  [+] github.com/oracle/skills/db#main #main @66074f9d (cached)

  |-- Skill integrated -> .agents/skills/


  [+] <project root> (local)

  |-- 4 skill(s) integrated -> .agents/skills/


[*] Installed 2 APM dependencies.

% ls .agents/skills/db

admin architecture devops migrations performance SKILL.md

agent containers features monitoring plsql sql-dev

appdev design frameworks ords security sqlcl

% 


今回の記事は以上になります。

完

2024年4月9日火曜日

Oracle CloudのApplication Performance MonitoringのReal User MonitorをAPEXアプリケーションに組み込む

GitHubにoracle-quickstartというリポジトリがあり、そこにOracle Cloudの監視および管理(Observability and Management)に含まれるアプリケーション・パフォーマンス・モニタリング(Application Performance Monitoring)のリアル・ユーザー・モニターをOracle APEXアプリケーションに組み込む方法が紹介されています。

Set up a Real User Monitor for an APEX application with OCI Application Performance Monitoring
https://github.com/oracle-quickstart/oci-o11y-solutions/tree/main/knowlege-content/oracle-database/APEX/apm

設定手順がYouTubeのビデオで紹介されていて、その手順に従うと設定できました。ただしAlways Free(無償枠)の範囲だと、ビデオの後半で説明されているカスタム・ダッシュボードの作成とデータベースへのドリルダウンは(データベースのモニタリングが無償ではないため)できないようです。

本記事では、Oracle APEXに関わる設定で確認した内容を紹介します。

最初にAPMドメインを作成します。

Oracle Cloudのコンソールのメニューより、監視および管理を選択し、アプリケーション・パフォーマンス・モニタリングの管理を開きます。


すでに作成済みのAPMドメインがあればそれを利用するか、または新規に作成します。

今回は新規に作成します。APMドメインの作成をクリックします。


作成するAPMドメインの名前はAPEXとします。無償枠の範囲とするためAlways Freeドメインとして作成にチェックを入れます。

作成するコンパートメントを選んで、作成をクリックします。


大体、10分弱の時間がかかりましたが、APMドメインとしてAPEXが作成されました。

APMエージェントのダウンロードを開きます。


APEXアプリケーションに組み込むのはブラウザ・エージェントです。

YouTubeのビデオでは、これをコピーしてAPEXのアプリケーションに貼り付けるように案内していますが、GitHubにリアル・ユーザー・モニターのudfAttributesを含んだブラウザ・エージェントの記述があるので、そちらを使います。

ブラウザ・エージェントについて、以下で説明されています。


APEXアプリケーションに移ります。

今回はサンプル・データセットのEMP/DEPTをインストールしたときに作成できるアプリケーション、Demonstration - EMP / DEPTにブラウザ・エージェントを組み込みます。

組み込むブラウザ・エージェントを、以下よりコピペします。


グローバール・ページを開き、タイプが静的コンテンツのリージョンを作成します。識別のタイトルはRUM Agentとします。

ソースのHTMLコードにブラウザ・エージェントのコードを記述します。ページにJavaScriptのコードを埋め込むだけで、何も表示する必要はないため、外観のテンプレートはなしにします。


作成したAPMドメインAPEXの詳細を開き、データ・アップロード・エンドポイントとパブリック・データ・キーを確認します。これらの値は、ブラウザ・エージェントのコードに埋め込みます。


<APM Browser>の部分はAPEX UI、<Web App Name>はDemonstration - EMP / DEPTに置き換えます。2箇所ある<ociDataUploadEndpoint>をAPMドメインの詳細画面に記載のあるデータ・アップロード・エンドポイントに置き換え、<APM_Public_Datakey>をパブリック・データ・キーに置き換えます。


以上でAPEXアプリケーションへのブラウザ・エージェントの組み込みは完了です。

アプリケーションを実行し、色々と操作をします。


Oracle Cloudのコンソールよりアプリケーション・パフォーマンス・モニタリングのダッシュボードを開きます。


Oracleが標準で提供しているダッシュボードよりリアル・ユーザー・モニタリングを開きます。


ブラウザ・エージェントから取得した情報がダッシュボードに表示されます。


無償枠の範囲でできることは以上です。

YouTubeのビデオでは、ブラウザ・エージェントのudfAttributesに設定したUserName(APP_USER)、APEXSessioinId(APP_SESSION)、APEXPageId(APP_PAGE_ID)さらにAPEXDBClientId(APP_USER:APP_SESSIONはデータベースのV$SESSIONの列CLIENT_IDENTIFIERに設定されるため、この値を使ってDBの情報をドリルダウンできます)などの情報を使った、カスタムのダッシュボードの作成やデータベースの情報の参照方法を紹介しています。

完