raulrgmx/oci-deal-accelerator
1
0
Fork 0
forked from diegoecab/oci-deal-accelerator
Code Pull Requests Activity

Diagram generation: ref-arch-driven procedure + spec validator + KB enrichment

Browse Source 
The diagram path now follows a documented standard procedure (lookup
the closest Oracle Architecture Center reference → confirm components
→ author absolute_layout → spec validator → render → visually verify)
and ships persistent guardrails so layout regressions can't recur.

Persistent procedure changes (apply to all users, all sessions):
- tools/diagram_spec_validator.py — geometry checks (CONTAINER_TOO_THIN,
  CONTAINER_PADDING_VIOLATION, LABEL_OVERFLOW_PARENT) run BEFORE either
  renderer (drawio + PPTX). Catches the subnet-collapse / label-overflow
  bugs that the post-render drawio validator missed.
- tools/oci_diagram_gen.py + tools/oci_pptx_diagram_gen.py — call the
  spec validator before emitting any output. Adds mysql / mysql_heatwave
  type aliases.
- tools/archcenter_pattern_lookup.py — scores against cached page
  descriptions (not just the 1-line summary), supports --queries for
  multi-fragment composition, and applies synonym expansion via
  kb/architecture-center/synonyms.yaml so "LB HA cross AD" matches
  "load balancer high availability availability domain".
- kb/architecture-center/synonyms.yaml — canonical synonym table
  (load balancer, autonomous database, data guard, …) used by the
  lookup scorer.

KB enrichment:
- tools/archcenter_description_fetcher.py + 121 cached _description.md
  under kb/diagram/assets/archcenter-refs/<slug>/. Removes the runtime
  dependency on docs.oracle.com when authoring specs and feeds the
  pattern-lookup scorer.
- 110+ cached .drawio / .svg / .png references for offline reuse,
  plus the OCI Toolkit v24.2 import (kb/diagram/assets/oci-toolkit-drawio).

Documentation:
- docs/skill/output-formats.md — new "Standard diagram-generation
  procedure (MANDATORY)" + geometry rules + the new validator entry.
- SKILL.md option 2 — references the mandatory procedure.
- README.md — describes the spec validator, archcenter_pattern_lookup
  and description fetcher, and updates the KB-health table.

Tooling that backs the procedure (cumulative across recent sessions):
tools/archcenter_case_runner.py, archcenter_batch_driver.py,
archcenter_zip_downloader.py, drawio_visual_validator.py,
drawio_fidelity_eval.py, harvest_drawio_icon.py, import_oci_library.py,
oci_pptx_diagram_gen.py, oci_pptx_render.py, refresh_pptx_icon_index.py.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
root
2026-04-25 21:15:21 -03:00
parent 2491c38d4b
commit b30a4f0d32
635 changed files with 365317 additions and 1014 deletions
Download Patch File Download Diff File Expand all files Collapse all files

260
kb/diagram/assets/archcenter-refs/enable-om-stack-monitoring-psft/_description.md Normal file
View File

@@ -0,0 +1,260 @@
# Enable Observability and Management Stack Monitoring for PeopleSoft
- Source: https://docs.oracle.com/en/solutions/enable-om-stack-monitoring-psft/index.html
- Date: 2024-12
- Type: reference-architecture
- Services: monitoring, compute
- Tags: observability, peoplesoft
## Summary (catalog)
Stack Monitoring for PeopleSoft. Automatic discovery of PIA, App Server, Process Scheduler, and database components. Metrics and alarms for performance and availability monitoring.
## Architecture (fetched from source)
Understand Oracle Cloud Observability and Management Platform Stack Monitoring Service for PeopleSoft Applications
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Previous
Next
JavaScript must be enabled to correctly display this content
- Enable Observability and Management Stack Monitoring for PeopleSoft
- Understand Oracle Cloud Observability and
Management Platform Stack Monitoring Service for PeopleSoft Applications
Understand Oracle Cloud Observability and
Management Platform Stack Monitoring Service for PeopleSoft Applications
The Stack Monitoring services in Oracle Cloud Observability and
Management Platform for PeopleSoft applications deliver essential insights into application health, including
real-time performance tracking and out-of-box metrics. These services offer integrated
visibility across your PeopleSoft stack, enabling efficient troubleshooting, performance
optimization, and proactive issue resolution to ensure seamless and reliable operation of
your enterprise applications.
Configure Your Environment
Before you can use the Stack Monitoring service, you must set up your Oracle Cloud
Infrastructure environment to allow communication between the different components and services. This
section explains the steps to set up Oracle Cloud Infrastructure for Stack
Monitoring.
Note:
The full procedures for completing the steps in this topic are beyond the scope of
this playbook. Please refer "Getting Started" in the Oracle Cloud
Infrastructure documentation, which you can access from "Explore More", elsewhere in this
playbook.
To properly configure your OCI envieronment, you need to complete these three
steps:
- Create or Designate a Compartment to Use
You can create a new compartment or use an existing compartment
to install and configure the Stack Monitoring service. Stack Monitoring
supports the following configurations to create a single-pane of glass for
monitoring all resources:
- All resources are deployed within the monitoring
compartment.
- Resources deployed in a compartment different than the
monitoring compartment.
- Install Management Agents
Next, you need to install the Management Agent, which is a
prerequisite for using the Stack Monitoring service. You can learn more
about the Management Agent in the following topic, "Learn About the
Management Agent in Oracle Cloud
Infrastructure ".
- Enable the Stack Monitoring Service
Finally, you need to enable the Stack Monitoring service, from
the Oracle Cloud
Infrastructure console. Navigate to Stack Monitoring located under Observability
and Management, Stack Monitoring. Select the compartment you want to
monitor, and click Enable Stack Monitoring .
Learn About the Management Agent
in Oracle Cloud
Infrastructure
The Management Agent in OCI is a lightweight software component that
facilitates monitoring and management of on-premises resources and hybrid cloud
environments. It securely connects these resources to OCI services such as Monitoring,
Logging, and Operations Insights, enabling centralized visibility and control. As mentioned
in the previous topic you need to set up this component to deploy stack monitoring.
The key Management Agent features are:
- Monitoring: Provides detailed metrics and logs from on-premises resources
to OCI Monitoring.
- Logging: Sends log data from on-premises environments to OCI Logging for
analysis and troubleshooting.
- Operations Insights: Enables operational insights and automation for
hybrid cloud environments.
- Security: Ensures secure communication with OCI using encryption and
authentication mechanisms.
See "Management Agent" in the Oracle Cloud Infrastructure Documentation, which you can
access from"Explore More".
Title and Copyright Information
Enable Observability and Management Stack Monitoring for PeopleSoft
G19528-01
December 2024
Copyright © 2024,
Oracle and/or its affiliates.