Diagram generation: ref-arch-driven procedure + spec validator + KB enrichment
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
@@ -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.
|
||||
Reference in New Issue
Block a user